Panoramica dell'API Geocoding

Sviluppatori dello 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 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 i segnaposto su una mappa o per centrare o riposizionare la mappa all'interno del frame della 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 Geocoding 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 seguente tabella riepiloga le risorse disponibili tramite l'API Geocoding insieme ai dati restituiti da ciascun endpoint.

Risorse di dati Dati restituiti Formato del 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
Geocoding inverso Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Risposte di geocodifica inversa nella guida Richiesta e risposta di geocodifica inversa.
Geocoding del luogo Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta Risposte di geocodifica inversa nella guida Richiesta e risposta di geocodifica del luogo.

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 ulteriori dettagli, consulta Parametri di geocodifica.
3 Prova a inviare 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 posizione. 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 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 della mappa o per fornire indicatori su una mappa in base a un indirizzo noto.

Librerie client disponibili

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

Passaggi successivi