![Panoramica dell'API Geolocation](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=0000&hl=it)
L'API Geolocation è un servizio che accetta una richiesta HTTPS con ripetitori di telefonia mobile e punti di accesso Wi-Fi che un client mobile è in grado di rilevare. Ritorna coordinate di latitudine/longitudine e un raggio che indica la precisione del per ogni input valido.
Perché utilizzare l'API Geolocation
Utilizzare l'API Geolocation per individuare i dispositivi mobili che non forniscono geolocalizzazione nativa le funzionalità di machine learning.
Cosa puoi fare con l'API Geolocation
Con l'API Geolocation, puoi utilizzare i dati geospaziali provenienti da torri cellulari e 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 campi dati di dispositivi mobili, ripetitori e dati dell'array dei punti di accesso Wi-Fi per restituire le coordinate di latitudine/longitudine . Accetta una richiesta POST HTTPS al proprio endpoint insieme a una richiesta strutturata JSON. del testo. 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 i dati per una serie di campi di dati cellulare comuni, come indicato di seguito.
Risorse
La tabella seguente riassume i campi nel corpo della richiesta dell'endpoint di geolocalizzazione insieme al tipo di dati forniti da queste query.
Risorse di dati | Dati restituiti | Formato di reso |
---|---|---|
Campi 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, come il prefisso della località e i codici paese dei cellulari. | ||
Dati dei punti di accesso Wi-Fi, come l'indirizzo MAC e la potenza del segnale. |
Come utilizzare l'API Geolocation
1 | Configurazione | Inizia con Configura il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
2 | Provare una richiesta di geolocalizzazione | Una volta ottenuta una chiave API, puoi iniziare a testare l'API Geolocation utilizzando cURL o Postino. Vedi Richieste di esempio Per informazioni dettagliate, consulta la guida Richieste e risposte di geolocalizzazione. |
3 | Recuperare il cellID da diverse torri radio | Vedi Calcolo dell'ID cella e il calcolo di newRadioCellID per accedere rispettivamente alle torri più vecchie e più nuove. |
4 | Nozioni di base sulle risposte | Esplora le risposte dei dati di geolocalizzazione per prepararti a utilizzare i dati di altitudine per la tua app. Consulta Risposte di geolocalizzazione per maggiori dettagli. |
Librerie client disponibili
Chiama questa API nella lingua di la tua scelta tramite una delle seguenti librerie client:
- Java Client per i servizi Google Maps
- Python Client per i servizi Google Maps
- Client Go per i servizi Google Maps
- Node.js Client per i servizi Google Maps
Client Java, client Python, client Go e client Node.js per Google Maps I servizi sono librerie client supportate dalla community, open source secondo Licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.
Passaggi successivi
- Guida introduttiva a richieste e risposte di esempio: vai a Richiesta e risposta di geolocalizzazione
- Segui le best practice: vai a Best practice sui servizi web.
- Informazioni sulla fatturazione: vai a Utilizzo e fatturazione.