Présentation de l'API Geolocation

L'API Geolocation est un service qui accepte les requêtes HTTPS pour les antennes-relais et les points d'accès Wi-Fi qu'un client mobile peut détecter. Elle renvoie des coordonnées de latitude/longitude et un rayon indiquant la précision du résultat pour chaque entrée valide.

Pourquoi utiliser l'API Geolocation ?

Utilisez l'API Geolocation pour localiser les appareils mobiles qui ne proposent pas de fonctionnalités de géolocalisation natives.

Ce que vous pouvez faire avec l'API Geolocation

Avec l'API Geolocation, vous pouvez utiliser des données géospatiales provenant d'antennes-relais et de nœuds Wi-Fi pour obtenir la position d'un appareil qui ne dispose pas de la géolocalisation native ni du GPS.

Fonctionnement de l'API Geolocation

L'API Geolocation utilise des champs de données d'appareils mobiles, des données d'antennes-relais et des données de tableau de points d'accès Wi-Fi pour renvoyer des coordonnées de latitude/longitude et un rayon de précision. Il accepte une requête HTTPS POST à son point de terminaison avec un corps de requête structurée JSON. L'exemple suivant montre l'URL de la requête et un exemple de corps de requête : 

curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d \
'{ "homeMobileCountryCode":310,
   "homeMobileNetworkCode":410,
   "radioType":"gsm",
   "carrier":"Vodafone",
   "considerIp":true
}'
L'API peut renvoyer des données pour un certain nombre de champs de données mobiles courants, comme indiqué ci-dessous.

Ressources

Le tableau suivant récapitule les champs du corps de la requête de l'appel du point de terminaison de géolocalisation, ainsi que le type de données fournies par ces requêtes.

Ressources de données Données renvoyées Format renvoyé
Champs de données sur les appareils mobiles, par exemple les informations sur l'opérateur, l'appareil et le réseau. Des coordonnées de latitude/longitude et un rayon de précision JSON
Données des antennes-relais, telles que l'indicatif de zone et les codes pays mobiles
Données des points d'accès Wi-Fi, telles que l'adresse MAC et l'intensité du signal.

Utiliser l'API Geolocation

1 Configuration Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration.
2 Envoyer une requête de géolocalisation Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Geolocation à l'aide de cURL ou de Postman. Pour en savoir plus, consultez la section Exemples de requêtes du guide Requêtes et réponses de géolocalisation.
3 Obtenir l'ID de la cellule GSM de différentes antennes-relais Consultez les sections Calculer l'ID de la cellule et Calculer le nouvel ID de cellule radio pour accéder respectivement aux antennes les plus anciennes et aux nouvelles.
4 Comprendre les principes de base des réponses Explorez les réponses des données de géolocalisation pour vous préparer à utiliser les données d'altitude pour votre application. Pour en savoir plus, consultez Réponses de géolocalisation.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes:

Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et des exemples de code.

Étapes suivantes