Présentation de l'API Geolocation

L'API Geolocation est un service qui accepte les requêtes HTTPS avec les antennes-relais et les points d'accès Wi-Fi détectés par un client mobile. 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.

Fonctionnalités de l'API Geolocation

Avec l'API Geolocation, vous pouvez 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 la géolocalisation native ni du GPS.

Fonctionnement de l'API Geolocation

L'API Geolocation utilise les champs de données d'appareils mobiles, les données des antennes-relais et les données des tableaux de points d'accès Wi-Fi pour renvoyer des coordonnées de latitude/longitude et un rayon de précision. Elle accepte les requêtes HTTPS POST adressées à leur 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 courants de données mobiles, 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 renvoyé
Champs de données de l'appareil mobile (informations sur l'opérateur, l'appareil et le réseau, par exemple). Coordonnées de latitude/longitude et rayon de précision JSON
Données des antennes-relais de téléphonie mobile, telles que les indicatifs de zone d'emplacement et les codes pays des appareils 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 Essayer 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 cellule de différentes antennes-relais Consultez les sections Calculer l'ID de cellule et Calculer le nouvel ID de cellule radio pour accéder respectivement aux antennes-relais les plus anciennes et les plus récentes.
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 un exemple de code.

Étapes suivantes