Panoramica dell'API Geolocation

L'API Geolocation è un servizio che accetta una richiesta HTTPS con il ripetitore di telefonia mobile e punti di accesso Wi-Fi che un client per dispositivi mobili può rilevare. Restituisce le coordinate di latitudine/longitudine e un raggio che indica l'accuratezza del risultato per ogni input valido.

Perché utilizzare l'API Geolocation

Utilizza l'API Geolocation per individuare i dispositivi mobili che non forniscono funzionalità native di geolocalizzazione.

Cosa puoi fare con l'API Geolocation

Con l'API Geolocation, puoi utilizzare i dati geospaziali di torri cellulari e nodi Wi-Fi per ottenere la posizione di un dispositivo che non è dotato di geolocalizzazione o GPS nativo.

Come funziona l'API Geolocation

L'API Geolocation utilizza i campi di dati del dispositivo cellulare, i dati delle torri cellulari e i dati dell'array di punti di accesso Wi-Fi per restituire le coordinate di latitudine/longitudine e un raggio di accuratezza. Accetta una richiesta POST HTTPS al suo endpoint e un corpo di richiesta strutturato JSON. L'esempio seguente mostra l'URL della richiesta e il corpo della richiesta di esempio: 

    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 può restituire dati per una serie di campi di rete dati comuni, come indicato di seguito.

Risorse

La tabella riportata di seguito riassume i campi nel corpo della richiesta della chiamata di endpoint di geolocalizzazione, insieme al tipo di dati forniti da tali query.

Risorse dei dati Dati restituiti Formato restituito
Campi dei dati della cella, ad esempio informazioni sull'operatore, sul dispositivo e sulla rete. Coordinate di latitudine/longitudine e raggio di precisione JSON
Dati delle torri cellulare, come prefisso della località e codici paese per dispositivi mobili.
Dati dei punti di accesso Wi-Fi, ad esempio indirizzo MAC e intensità del segnale.

Come utilizzare l'API Geolocation

1 Configurazione Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni per la configurazione che seguono.
2 Prova una richiesta di geolocalizzazione Quando disponi di una chiave API, puoi iniziare a testare l'API Geolocation utilizzando cURL o Postman. Per dettagli, consulta le richieste di esempio nella guida Richieste e risposte di geolocalizzazione.
3 Procurati il cellID di diversi torri radio Consulta Calcolo del cellID e Calcolo del nuovo RadioCellID per ottenere rispettivamente l'accesso alle torri meno recenti e più recenti.
4 Nozioni di base sulle risposte Esplora le risposte ai dati di geolocalizzazione per prepararti a utilizzare i dati di elevazione per la tua app. Per i dettagli, consulta Risposte di geolocalizzazione.

Librerie client disponibili

Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:

Il client Java, il client Python, il client Go e il client Node.js per Google Maps Services sono librerie client supportate dalla community, open source basate sulla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare le istruzioni di installazione e il codice campione.

Passaggi successivi