Panoramica dell'API Geolocation

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:

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