Panoramica dell'API Geocoding

Sviluppatori dello Spazio economico europeo (SEE)

L'API Geocoding è un servizio che accetta un luogo sotto forma di 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.

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 per gli indirizzi.
  • Indirizzi per insiemi 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 che la geocodifica inversa:

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

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

Risorse

La tabella seguente riassume le risorse disponibili tramite l'API Geocoding, insieme ai dati restituiti da ciascun metodo.

Risorse di dati Dati restituiti Formato di reso
Geocodifica Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Risultati nella guida Richiesta e risposta di geocodifica.
  • JSON
  • XML
Geocodifica inversa Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Risposte di geocodifica inversa nella guida alle richieste e alle risposte di geocodifica inversa.
Geocodifica dei luoghi Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Risposte di geocodifica inversa nella guida alle richieste e alle risposte di geocodifica dei luoghi.

Come utilizzare l'API Geocoding

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

Librerie client disponibili

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

I client Java, Python, Go e Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source con licenza Apache 2.0. Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice campione.

Passaggi successivi