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 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 il sito web o l'applicazione mobile quando vuoi utilizzare i dati di geocodifica all'interno di mappe fornite da una delle API di 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 e predefiniti per il posizionamento dei contenuti delle applicazioni 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, inclusi:

  • 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 vincolarli 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 oppure 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 diversi scenari, tra cui consegne o ritiri.

La demo seguente utilizza il servizio di geocodifica 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 tabella riportata di seguito riassume le risorse disponibili tramite l'API Geocoding insieme ai dati restituiti da ciascun endpoint.

Risorse di dati Dati restituiti Formato restituito
Geocodifica Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta i risultati nella guida Richiesta di geocodifica e risposta.
  • JSON
  • XML
Geocodifica inversa Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Invertire le risposte di geocodifica nella guida Richiesta e risposta di geocodifica inversa.
Effettua la geocodifica Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Invertire le risposte di geocodifica nella guida luogo di 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 che seguono.
2 Prova a inviare una richiesta di geocodifica Dopo aver ottenuto 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 dell'indirizzo o dei componenti. Per ulteriori dettagli, consulta Parametri di geocodifica.
3 Provare una richiesta di geocodifica inversa Fornisci le coordinate di latitudine/longitudine e la chiave API per ottenere i componenti dell'indirizzo per l'indirizzo leggibile più vicino per la località. Per ulteriori dettagli, consulta la sezione Richieste di geocodifica inversa .
4 Nozioni di base sulle risposte Tutti gli endpoint nell'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 Integra i dati di geocodifica nella tua app. Puoi utilizzare i dati di geocodifica per ottenere indirizzi da indicatori di 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:

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 in base alla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare le istruzioni di installazione e il codice campione.

Passaggi successivi