Présentation de l'API Geolocation

L'API Geolocation est un service qui accepte une requête HTTPS avec les antennes-relais et les points d'accès Wi-Fi qu'un client mobile peut détecter. Il renvoie les 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 fournissent pas de fonctionnalités de géolocalisation natives.

Fonctionnalités de l'API Geolocation

L'API Geolocation vous permet d'utiliser les données géospatiales des antennes-relais et des nœuds Wi-Fi pour obtenir la position d'un appareil qui ne dispose pas de géolocalisation ni de GPS natifs.

Fonctionnement de l'API Geolocation

L'API Geolocation utilise les champs de données des appareils mobiles, les données des antennes-relais et les données du tableau des points d'accès Wi-Fi pour renvoyer les coordonnées de latitude/longitude et un rayon de précision. Il accepte une requête HTTPS POST à son point de terminaison, ainsi qu'un corps de requête structuré au format 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 de 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 de retour
Champs de données des appareils mobiles, tels que les informations sur l'opérateur, l'appareil et le réseau. Coordonnées de latitude/longitude et rayon de précision JSON
Données des antennes-relais, telles que le code de zone de localisation 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 Configurer Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration.
2 Essayer une demande de géolocalisation Une fois que vous avez obtenu une clé API, vous pouvez commencer à tester l'API Geolocation à l'aide de cURL ou de Postman. Pour en savoir plus, consultez les exemples de requêtes dans le guide Requêtes et réponses de géolocalisation.
3 Obtenir le cellID de différentes antennes-relais Consultez Calculer cellID et Calculer newRadioCellID pour accéder aux anciennes et nouvelles antennes, respectivement.
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 à l'aide de 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 un exemple de code.

Étape suivante