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 della versione 4 dell'API Geocoding include la release dei seguenti endpoint:
- Geocodifica un indirizzo: coordinate geografiche degli indirizzi. Chiamata anche geocodifica diretta.
- Geocodifica una località - Indirizzi per insiemi di coordinate di latitudine e longitudine. Questo processo è chiamato anche geocodifica inversa.
- Geocodifica dei luoghi: recupera un indirizzo da un ID luogo.
- Cerca destinazioni : cerca una destinazione da un indirizzo, un ID luogo o una località.
Puoi controllare dove vengono visualizzati i risultati e limitarli a una determinata regione, contea o codice postale.
Prova la demo
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 o per centrare o riposizionare la mappa all'interno del frame 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 riassume le risorse disponibili tramite l'API Geocoding, insieme ai dati restituiti da ciascun metodo.
| Risorse di dati | Dati restituiti | Formato di reso |
|---|---|---|
| Geocodifica | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica. |
|
| Geocodifica inversa | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica inversa. | |
| Geocodifica dei luoghi | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica dei luoghi. | |
| Ricerca della destinazione | Restituisce informazioni dettagliate su varie destinazioni in base a diversi criteri di input, come un indirizzo, un ID luogo o le coordinate di latitudine e longitudine. Consulta la documentazione sulla ricerca della destinazione. |
Canali delle fasi di lancio
La versione 4 dell'API Geocoding ha canali separati per le funzionalità GA, Preview e Experimental. Se vuoi utilizzare le funzionalità in anteprima o sperimentali, assicurati di specificare il canale corretto nella richiesta. Ad esempio, per accedere alle funzionalità dell'endpoint Destinations in Experimental, utilizza questa richiesta HTTP: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Fase di lancio | Nome del canale |
|---|---|
| GA | /v4/ |
| Anteprima | /v4beta/ |
| Sperimentale | /v4alpha/ |
- Consulta il riferimento REST per un elenco e una descrizione di tutte le risorse REST disponibili.
- Per saperne di più su ogni fase, consulta Fasi di lancio.
Funzionalità dell'API Geocoding v4
La versione 4 dell'API Geocoding offre queste nuove funzionalità.
Metodo di ricerca della destinazione
La versione 4 introduce un metodo 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 le 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 passate all'SDK Navigation per un routing preciso.
Implementato sulla piattaforma standard di Google Cloud
L'API Geocoding v4 è implementata nell'infrastruttura di servizi su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile con opzioni di sicurezza avanzate come OAuth. Questo design API standard offre un livello di coerenza tra le API che migliora l'efficienza dello sviluppo con l'API Geocoding v4.
Supporto di OAuth aggiunto
L'API Geocoding v4 supporta l'utilizzo di OAuth 2.0 per l'autenticazione. Google supporta scenari OAuth 2.0 comuni, come quelli per un server web.
Aggiunto il supporto della maschera di campo
Utilizza le maschere di campo per specificare quali informazioni deve restituire la risposta. Per i metodi Geocodifica un indirizzo, Geocodifica una località e Geocodifica di un luogo, per impostazione predefinita vengono restituiti tutti i campi dell'oggetto di risposta. Per il metodo Cerca destinazioni, devi specificare una maschera di campo nella richiesta API.
Sicurezza delle API
L'API Geocoding v4 è progettata come API server-to-server. Le chiamate dirette lato client da un browser espongono le chiavi API a un rischio significativo di furto e uso improprio, poiché le restrizioni dei referrer HTTP non sono una protezione sufficiente per gli endpoint dei servizi web.
Ti consigliamo vivamente di chiamare l'API Geocoding v4 dal tuo server di backend. Per maggiori dettagli sui pattern di implementazione sicuri e sulle alternative per le esigenze lato client, consulta Considerazioni sulla sicurezza.