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