Présentation de l'API Geolocation

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

Pourquoi utiliser l'API Geolocation ?

Utiliser l'API Geolocation pour localiser les appareils mobiles qui n'offrent pas de géolocalisation native caractéristiques.

Possibilités offertes par l'API Geolocation

Avec l'API Geolocation, vous pouvez utiliser les données géospatiales des antennes-relais de téléphonie mobile et les 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 antennes-relais et les données d'un réseau de points d'accès WiFi pour renvoyer des coordonnées de latitude/longitude et une précision du rayon d'action. Il accepte une requête HTTPS POST vers son point de terminaison, ainsi qu'une 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 cellulaires courants, comme indiqué ci-dessous.

Ressources

Le tableau suivant récapitule les champs du corps de la requête 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 de retour
Champs de données de l'appareil mobile telles que des 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 comme l'indicatif de zone et l'indicatif du pays mobile.
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 et suivez les instructions de configuration qui s'affichent.
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 Facteur. Consultez la section Exemples de requêtes. dans le guide Requêtes et réponses de géolocalisation.
3 Obtenir l'identifiant de la cellule GSM à partir de différentes antennes-relais Voir Calculer l'ID de cellule et Calculating newRadioCellID pour accéder respectivement aux tours plus anciennes et plus récentes.
4 Comprendre les principes de base des réponses Explorez les réponses aux données de géolocalisation pour préparer l'utilisation des données d'altitude pour votre application. Voir Réponses de géolocalisation pour en savoir plus.

Bibliothèques clientes disponibles

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

Les clients Java, Python, Go et Node.js pour Google Maps Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du 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