![Présentation de l'API Geolocation](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=19&hl=fr)
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:
- Java Client pour les services Google Maps
- Python Client pour les services Google Maps
- Client Go pour les services Google Maps
- Node.js Client pour les services Google Maps
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
- Premiers pas avec des exemples de requêtes et de réponses: accédez à Requête et réponse de géolocalisation
- Suivez les bonnes pratiques: accédez à Bonnes pratiques pour les services Web.
- Comprendre la facturation: accédez à Utilisation et facturation.