Panoramica dell'API Geocoding

L'API Geocoding è un servizio che accetta un luogo come indirizzo, coordinate di latitudine e longitudine o ID luogo. Converte l'indirizzo in coordinate di latitudine e longitudine e in un ID luogo oppure converte le coordinate di latitudine e longitudine o un ID luogo in un indirizzo.

Perché utilizzare l'API Geocoding

Utilizza l'API Geocoding per un sito web o un'applicazione mobile quando vuoi usare dati di geocodifica all'interno di mappe fornite da una delle API Google Maps Platform. Con l'API Geocoding, puoi utilizzare gli indirizzi per posizionare gli indicatori su una mappa o convertire un indicatore sulla mappa in un indirizzo. Questo servizio è progettato per la geocodifica di indirizzi statici predefiniti per il posizionamento dei contenuti dell'applicazione su una mappa.

Cosa puoi fare con l'API Geocoding

Puoi utilizzare l'API Geocoding per ottenere dati di geocodifica per uno o più indirizzi o luoghi, tra cui:

  • Coordinate geografiche degli indirizzi.
  • Indirizzi per le serie di coordinate di latitudine e longitudine.
  • Indirizzi per gli ID luogo.

Puoi controllare dove vengono visualizzati i risultati e limitarli a una determinata regione, contea o codice postale.

Come funziona l'API Geocoding

L'API Geocoding esegue sia la geocodifica sia la geocodifica inversa:

  • Geocodifica: converte indirizzi quali "1600 Amphitheatre Parkway, Mountain View, CA" in coordinate di latitudine e longitudine o ID luogo. Puoi utilizzare queste coordinate per posizionare indicatori su una mappa oppure per centrare o riposizionare la mappa all'interno del riquadro di visualizzazione.
  • Geocodifica inversa: converte le coordinate di latitudine/longitudine o un ID luogo in un indirizzo leggibile. Puoi utilizzare gli indirizzi per diversi scenari, tra cui consegne o ritiri.

La demo seguente utilizza il servizio Geocoding tramite l'API Maps JavaScript per dimostrare come funziona l'API Geocoding. Apri la mappa in una scheda separata per visualizzare altri dettagli e opzioni.

Risorse

La tabella seguente riassume le risorse disponibili tramite l'API Geocoding e i dati restituiti da ciascun endpoint.

Risorse di dati Dati restituiti Formato di reso
Geocodifica Restituisce indirizzo, componenti di indirizzo e tipi di indirizzo. Consulta Risultati nella guida Richiesta e risposta di geocodifica.
  • JSON
  • XML
Geocodifica inversa Restituisce indirizzo, componenti di indirizzo e tipi di indirizzo. Consulta la pagina Invertire le risposte di geocodifica nella guida Inverti richieste e risposte di geocodifica.
Geocodifica di luoghi Restituisce indirizzo, componenti di indirizzo e tipi di indirizzo. Consulta la sezione Invertire le risposte di geocodifica nella guida Posiziona richiesta e risposta di geocodifica.

Come utilizzare l'API Geocoding

1 Configurazione. Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Prova con una richiesta di geocodifica Una volta ottenuta una chiave API, puoi iniziare a testare l'API Geocoding direttamente da cURL o da un browser. Dovrai fornire i parametri di ricerca corretti per le ricerche di indirizzi o componenti. Consulta Parametri di geocodifica per dettagli.
3 Prova con una richiesta di geocodifica inversa Fornisci le coordinate di latitudine/longitudine insieme alla chiave API per ottenere i componenti dell'indirizzo più vicino leggibile per quella località. Per maggiori dettagli, consulta Invertire le richieste di geocodifica .
4 Nozioni di base sulle risposte Tutti gli endpoint dell'API Geocoding restituiscono gli stessi dati in formato JSON o XML. Consulta la sezione Risposte di geocodifica per una spiegazione di dati, codici di stato e messaggi di errore.
5 Incorpora dati di geocodifica nella tua app. Puoi utilizzare i dati di geocodifica per ottenere indirizzi dagli indicatori o per fornire indicatori su una mappa sulla base di un indirizzo noto.

Librerie client disponibili

Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:

Il client Java, il client Python, il client Go e il client Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source secondo la licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.

Passaggi successivi