Présentation de l'API Geolocation

L'API Geolocation est un service qui accepte une requête HTTPS avec l'antenne-relais et les points d'accès Wi-Fi qu'un client mobile peut détecter. Elle 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 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 les données géospatiales des antennes-relais et des nœuds Wi-Fi pour obtenir la position d'un appareil qui n'est pas basé sur la géolocalisation ou le GPS.

Fonctionnement de l'API Geolocation

L'API Geolocation utilise des champs de données des appareils mobiles, des données des antennes-relais de téléphonie mobile et des données 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 envoyée à son point de terminaison avec un corps de requête structuré JSON. L'exemple suivant présente l'URL de la requête et un exemple de corps de requête : 

    https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

    {
      "homeMobileCountryCode": 310,
      "homeMobileNetworkCode": 410,
      "radioType": "gsm",
      "carrier": "Vodafone",
      "considerIp": true,
      "cellTowers": [
        // See the Cell Tower Objects section below.
      ],
      "wifiAccessPoints": [
        // See the WiFi Access Point Objects section below.
      ]
    }
L'API peut renvoyer des données pour plusieurs champs de données mobiles courants, comme indiqué ci-dessous.

Ressources

Le tableau suivant récapitule les champs dans le 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 (opérateur, appareil, réseau, etc.). Coordonnées de latitude/longitude et rayon de précision JSON
Données des antennes-relais (indicatifs régionaux et mobiles, par exemple)
Données des points d'accès Wi-Fi, telles que l'adresse MAC et la puissance du signal.

Utiliser l'API Geolocation

1 Commencer Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent.
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 de géolocalisation et réponses.
3 Obtenir l'identification de la cellule GSM à partir des différentes antennes radio Pour accéder respectivement aux antennes plus anciennes et plus récentes, consultez les sections Calcul de l'ID de la cellule et Calcul de la nouvelle valeur RadioCellID.
4 Comprendre les principes de base des réponses Explorez les réponses des données de géolocalisation afin de vous préparer à utiliser les données d'altitude pour votre application. Pour en savoir plus, consultez la section Réponses de la géolocalisation.

Bibliothèques clientes disponibles

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

Le client Java, le client Python, le client Go et le client Node.js pour les services Google Maps sont des bibliothèques clientes compatibles avec la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étapes suivantes