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:
Questa release dell'API Geocoding v4 include il rilascio dei seguenti endpoint:
- (Anteprima) Geocodifica un indirizzo — Coordinate geografiche per gli indirizzi. Chiamato anche geocodifica diretta.
- (Anteprima) Geocodifica di una località — Indirizzi per insiemi di coordinate di latitudine e longitudine. Chiamata anche geocodifica inversa.
- (Anteprima) Geocodifica del luogo — Recupera un indirizzo da un ID luogo.
- (Anteprima) Cerca destinazioni — Cerca una destinazione da un indirizzo, un ID luogo o una posizione.
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 marcatori su una mappa o per centrare o riposizionare la mappa all'interno del riquadro di visualizzazione.
- Geocodifica inversa: Converte le coordinate di latitudine e longitudine o un ID luogo in un indirizzo leggibile. Puoi utilizzare gli indirizzi per una serie di scenari, tra cui consegne o ritiri.
La tabella seguente 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 la documentazione relativa alla risposta di geocodifica. |
|
| Geocoding inverso | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione Risposta di geocodifica inversa. | |
| Geocoding del luogo | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica del luogo. | |
| Ricerca di destinazioni | Restituisce informazioni dettagliate su varie destinazioni in base a diversi criteri di input, come un indirizzo, un ID luogo o coordinate di latitudine e longitudine. Consulta la documentazione Ricerca destinazione. |
Funzionalità dell'API Geocoding v4
La versione 4 dell'API Geocoding offre queste nuove funzionalità.
Endpoint di ricerca delle destinazioni
La v4 introduce un endpoint di ricerca delle destinazioni che ti consente di recuperare informazioni dettagliate su varie destinazioni in base a diversi criteri di input, come un indirizzo, un ID luogo o coordinate di latitudine e longitudine. La risposta include riepiloghi basati sull'AI e token dei punti di navigazione che contengono informazioni contestuali che possono essere trasmesse all'SDK Navigation per un calcolo del percorso preciso.
Implementato sulla piattaforma standard Google Cloud
L'API Geocoding v4 è implementata nell'infrastruttura di servizio su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile con opzioni di sicurezza avanzate come OAuth. Questo design standard delle API offre un livello di coerenza tra le API che migliora l'efficienza dello sviluppo con l'API Geocoding v4.
Aggiunta del supporto OAuth
L'API Geocoding v4 supporta l'utilizzo di OAuth 2.0 per l'autenticazione. Google supporta gli scenari OAuth 2.0 comuni, ad esempio quelli per un server web.
Aggiunto il supporto della maschera di campo
Utilizza le maschere di campo per specificare le informazioni che la risposta deve restituire. Per gli endpoint Geocodifica un indirizzo, Geocodifica una località e Geocodifica di un luogo, tutti i campi dell'oggetto risposta vengono restituiti per impostazione predefinita. Per l'endpoint Cerca destinazioni, devi specificare una maschera di campo nella richiesta API.
Nessun costo per l'utilizzo durante l'anteprima
L'API Geocoding v4 è in fase di anteprima pre-GA e non è previsto alcun costo per l'utilizzo dell'API durante l'anteprima. Le chiamate API verranno visualizzate nella pagina Fatturazione di Cloud Console, ma gli addebiti saranno pari a 0 $.
Feedback
Questa è una funzionalità in anteprima. Apprezziamo il tuo feedback all'indirizzo geocoding-feedback-channel@google.com.