
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:
- Client Java per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client per i servizi Google Maps
- Client Node.js per i servizi Google Maps
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
- Per iniziare a utilizzare richieste e risposte di esempio: vai a Richiesta e risposta di geolocalizzazione
- Segui le best practice: consulta le best practice per i servizi web.
- Informazioni sulla fatturazione: vai a Utilizzo e fatturazione.