Géolocaliser un téléphone mobile perdu

Orange API ferme ses portes le service sera définitivement interrompu à dater du 12 septembre 2013

Pour en savoir : http://api.orange.com/fr/fermeture-orange-api

L’API location va vous permettre de localiser l’emplacement géographique de votre téléphone mobile en deux étapes.

A tous les internautes qui nous contactent :
-il ne sera pas possible de géolocaliser votre téléphone mobile si vous n’avez pas fait ces actions avant tout,
-vous ne pourrez pas géolocaliser un téléphone mobile déjà perdu via l’API location.

Attention, pour pouvoir géolocaliser votre téléphone mobile depuis notre API, il est nécessaire d’autoriser cette opération celui-ci au préalable et que le téléphone mobile soit allumé ; dans le cas contraire la géolocalisation ne sera pas réalisable.

Comment anticiper une perte ou vol de téléphone mobile ?
L'API location permet de localiser votre téléphone mobile et de récupérer les coordonnées (GPS).
Sachez que cette API fonctionne avec n'importe quel téléphone mobile sur le réseau GSM et chez l’opérateur Orange France (opérateurs partenaires/MVNO inclus) ; de plus, aucune installation sur le terminal n’est nécessaire pour que cela fonctionne.

1 pour commencer
-créez un compte sur notre site (http://api.orange.com) pour obtenir un identifiant appelé API Access Key (disponible dans votre espace personnel)
-achetez un pack de 10 euros (le minimum) pour utiliser le service (ces crédits n’ont pas de durée de vie, vous pourrez les utiliser quand vous le souhaiterez)
-rendez-vous dans votre espace personnel (rubrique « mes API » > configurer mes API > location API) afin de définir un nom de service qui vous sera unique.

2 autorisez votre téléphone mobile à être géolocalisé
-lancez la demande d’autorisation à votre téléphone mobile via la « méthode createAuthorization ». Cette étape est essentielle, sans elle, vous n’aurez pas l’autorisation de géolocaliser votre téléphone mobile.

Pour ce faire, exécutez la requête HTTP suivante (copiez cette URL dans votre navigateur par exemple) :
http://run.orangeapi.com/location/createAuthorization.xml?id=XXXXXXXXX&…

Comment compléter cette requête :
-le paramètre « id » correspond à votre API Access Key (récupérée dans votre espace personnel).
-le paramètre « number » correspond au numéro de téléphone du mobile (au format international).

Vous recevrez alors un premier SMS provenant du 20345 auquel il faudra répondre par « oui nom_de_votre_service » ; c’est cette action qui exécutera la demande d’autorisation de géolocalisation.
Enfin, un deuxième SMS vous sera envoyé (provenant toujours du 20345) ; il faudra alors envoyer « oui location » au 20633. Cette fois-ci, cette action autorisera votre téléphone mobile sur notre plateforme.

Important :
Sans ce processus, la géolocalisation du téléphone mobile sera interdite, il est donc inutile de réaliser celui-ci une fois le téléphone mobile perdu ou volé car vous ne pourrez alors plus répondre aux deux SMS nécessaires à l’autorisation du téléphone mobile.

Sachez également qu’il est inutile de refaire ce processus d’autorisation à chaque géolocalisation. Une fois effectué, l’autorisation est enregistrée. Il ne reste plus qu’à récupérer les données de positionnement du téléphone mobile pour le localiser.

3 géolocalisez votre téléphone mobile
Cette action est réalisable via la « méthode getLocation ».
Elle nécessite l’exécution de la requête HTTP suivante (copiez cette URL dans votre navigateur par exemple) :
http://run.orangeapi.com/location/getLocation.xml?id=XXXXXXXXX&number=3…

Comment compléter cette requête (les paramètres ne changent pas) :
-« id » correspond toujours à votre API Access Key
-« number » au numéro du téléphone mobile (au format international).

Les données de localisation vous seront transmises au format GPS. L’ API vous retournera les coordonnées X (longitude) et Y (latitude) du téléphone mobile ciblé. La précision peut varier de 300 m (en zone urbaine) à 30 km (en zone rurale) selon son emplacement.

4 les tarifs de ce service
Aucun coût d’installation, seules les communications sont payantes.
-la requête d’autorisation du téléphone mobile coûte 1 crédit.
-la requête de géolocalisation du téléphone mobile coûte 10 crédits.

Par exemple :
Le SMS reçu pour demander l’autorisation de géolocalisation vous coûtera 1 crédit. Et le SMS reçu pour géolocaliser le téléphone mobile vous coutera 10 crédits.
Pour plus de renseignements, cliquez ici pour accéder à la page des tarifs.

5 pour aller plus loin
Pour ceux qui souhaitent créer une petite application de géolocalisation de téléphone mobile en quelques lignes de code PHP, cliquez ici.

Soraya, Community Manager Orange API