Panoramica dell'API Geolocation

L'API Geolocation è un servizio che accetta una richiesta HTTPS con le torri cellulari e i punti di accesso Wi-Fi che un client mobile può rilevare. Restituisce 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à di geolocalizzazione native.

Cosa puoi fare con l'API Geolocation

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

Come funziona l'API Geolocation

L'API Geolocation utilizza i campi di dati dei dispositivi mobili, i dati delle torri cellulari e i dati degli array dei punti di accesso Wi-Fi per restituire le coordinate di latitudine/longitudine e un raggio di precisione. Accetta una richiesta POST HTTPS al suo endpoint insieme a un corpo della richiesta strutturato in formato JSON. L'esempio seguente mostra l'URL della richiesta e un esempio di corpo della richiesta: 

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

Risorse

La seguente tabella riassume i campi nel corpo della richiesta della chiamata dell'endpoint di geolocalizzazione, insieme al tipo di dati forniti da queste query.

Risorse di dati Dati restituiti Formato del reso
Campi di dati del dispositivo cellulare come informazioni su operatore, dispositivo e rete. Coordinate di latitudine/longitudine e un raggio di precisione JSON
Dati delle torri cellulari, come il codice area locale e i codici paese mobili.
Dati dei punti di accesso Wi-Fi, come indirizzo MAC e intensità del segnale.

Come utilizzare l'API Geolocation

1 Configurazione Inizia con la configurazione del progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Prova una richiesta di geolocalizzazione Una volta ottenuta una chiave API, puoi iniziare a testare l'API Geolocation utilizzando cURL o Postman. Per maggiori dettagli, consulta la sezione Richieste di esempio nella guida Richieste e risposte di geolocalizzazione.
3 Ottenere il CellID da diverse torri radio Consulta Calcolo di cellID e Calcolo di newRadioCellID per accedere rispettivamente alle torri più vecchie e più nuove.
4 Informazioni di base sulle risposte Esplora le risposte dei dati di geolocalizzazione per prepararti a utilizzare i dati di elevazione per la tua app. Per informazioni dettagliate, vedi Risposte di geolocalizzazione.

Librerie client disponibili

Chiama questa API nella lingua di tua scelta tramite una delle seguenti librerie client:

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

Passaggi successivi