Panoramica dell'API Geolocation

L'API Geolocation è un servizio che accetta una richiesta HTTPS con il ripetitore di telefonia mobile e i punti di accesso Wi-Fi che un client mobile è in grado di 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 dispositivi mobili che non offrono funzionalità di geolocalizzazione native.

Che 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 dispone di geolocalizzazione o GPS nativi.

Come funziona l'API Geolocation

L'API Geolocation utilizza i campi dei dati dei dispositivi mobili, 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 precisione. Accetta una richiesta POST HTTPS nel suo endpoint insieme a un corpo della richiesta strutturata JSON. L'esempio seguente mostra l'URL della richiesta e un corpo della richiesta di esempio:

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 della rete dati 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 dei dati del dispositivo cellulare, ad esempio informazioni su operatore, dispositivo e rete. Coordinate di latitudine/longitudine e raggio di precisione JSON
Dati delle torri cellulari, ad esempio il prefisso della località e i codici paese dei dispositivi mobili.
Dati dei punti di accesso Wi-Fi, ad esempio indirizzo MAC e intensità del segnale.

Come utilizzare l'API Geolocation

1 Configurazione Per iniziare, consulta Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Prova una richiesta di geolocalizzazione Dopo aver ottenuto una chiave API, puoi iniziare a testare l'API Geolocation utilizzando cURL o Postman. Per maggiori dettagli, consulta Richieste di esempio nella guida Richieste e risposte di geolocalizzazione.
3 Recuperare il cellID da torri radio diverse Consulta Calcolo di cellID e Calcolo di newRadioCellID per accedere rispettivamente a torri più vecchie e nuove.
4 Informazioni di base sulle risposte Esplora le risposte relative ai dati di geolocalizzazione per prepararti a utilizzare i dati sull'altitudine per la tua app. Consulta Risposte di geolocalizzazione per maggiori dettagli.

Librerie client disponibili

Chiama questa API nel linguaggio 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 e open source previste dalla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare istruzioni per l'installazione e codice di esempio.

Passaggi successivi