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 siti web o applicazioni mobile quando vuoi avvalerti dei 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 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 degli indirizzi.
  • Indirizzi per insiemi di coordinate di latitudine e longitudine.
  • Indirizzi per gli ID luogo.

Puoi controllare dove vengono visualizzati i risultati e vincolarli a una regione, una contea o un codice postale specifici.

Come funziona l'API Geocoding

L'API Geocoding esegue sia la geocodifica sia 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, oppure centrarla o riposizionarla all'interno dell'inquadratura.
  • Geocodifica inversa: converte le coordinate di latitudine/longitudine o un ID luogo in un indirizzo leggibile. Puoi utilizzare gli indirizzi per diversi scenari, incluse consegne o ritiri.

La seguente demo 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 ulteriori opzioni e dettagli.

Risorse

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

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

Come utilizzare l'API Geocoding

1 Preparati. Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione che seguono.
2 Prova una richiesta di geocodifica Dopo aver ottenuto una chiave API, puoi iniziare a testare l'API Geocoding direttamente da cURL o un browser. Dovrai fornire i parametri di ricerca corretti per le ricerche di indirizzi o componenti. Consulta Parametri di geocodifica per i dettagli.
3 Prova una richiesta di geocodifica inversa Fornisci le coordinate di latitudine/longitudine insieme alla chiave API per ottenere i componenti dell'indirizzo dell'indirizzo leggibile più vicino alla località. Per i dettagli, consulta la sezione Inverti richieste di geocodifica .
4 Informazioni di base sulle risposte Tutti gli endpoint nell'API Geocoding restituiscono gli stessi dati in formato JSON o XML. Consulta 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 nel linguaggio 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 e open source previste dalla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare istruzioni per l'installazione e codice di esempio.

Passaggi successivi