Panoramica dell'API Geocoding

Sviluppatori nello Spazio economico europeo (SEE)

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 le coordinate di latitudine e longitudine o un ID luogo in un indirizzo.

Perché utilizzare l'API Geocoding

Utilizza l'API Geocoding per il sito web o l'applicazione mobile quando vuoi utilizzare i dati di geocodifica all'interno delle mappe fornite da una delle API di Google Maps Platform. Con l'API Geocoding, puoi utilizzare gli indirizzi per posizionare indicatori su una mappa o convertire un indicatore su una 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 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: consente di convertire indirizzi come "1600 Amphitheatre Parkway, Mountain View, CA" in coordinate di latitudine e longitudine o ID luogo. Puoi utilizzare queste coordinate per inserire indicatori su una mappa o per centrarla o riposizionarla all'interno del riquadro della visualizzazione.
  • Geocodifica inversa: consente di convertire 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 demo seguente utilizza il servizio Geocoding tramite l'API Maps JavaScript per dimostrare il funzionamento dell'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, nonché i dati restituiti da ciascun endpoint.

Risorse di dati Dati restituiti Formato di reso
Geocoding Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta 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 Risposte alla geocodifica inversa nella guida alle richieste e alle risposte di geocodifica inversa.
Geocoding dei luoghi Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta Risposte alla geocodifica inversa nella guida alla richiesta e alla risposta di geocodifica dei luoghi.

Come utilizzare l'API Geocoding

1 Esegui la configurazione. Per iniziare, consulta la sezione Configurare 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. Dovrai fornire i parametri di ricerca corretti per le ricerche di indirizzi o componenti. Per maggiori dettagli, consulta Parametri di geocodifica.
3 Provare una richiesta di geocodifica inversa Fornisci le coordinate di latitudine/longitudine insieme alla tua chiave API per ottenere i componenti dell'indirizzo per l'indirizzo leggibile più vicino per quella località. Per maggiori dettagli, consulta Richieste di geocodifica inversa.
4 Informazioni di base sulle risposte Tutti gli endpoint dell'API Geocoding restituiscono gli stessi dati in 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 gli indirizzi dagli indicatori sulla mappa o per fornire indicatori su una mappa in base a un indirizzo noto.

Librerie client disponibili

Chiama questa API nella lingua di tuo interesse 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 ai sensi della licenza Apache 2.0. Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice di esempio.

Passaggi successivi