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 la release dei seguenti endpoint:
- Geocodifica un indirizzo : coordinate geografiche per gli indirizzi. È detta anche geocodifica diretta.
- Geocodifica una località — indirizzi per insiemi di coordinate di latitudine e longitudine. È detta 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 limitare i risultati a una regione, una contea o un codice postale specifico.
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 indicatori 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 riassume le risorse disponibili tramite l'API Geocoding e i dati restituiti da ogni metodo.
| Risorse dati | Dati restituiti | Formato di restituzione |
|---|---|---|
| Geocodifica | Restituisce indirizzo, componenti dell'indirizzo e tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica. |
|
| Geocodifica inversa | Restituisce indirizzo, componenti dell'indirizzo e tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica inversa. | |
| Geocodifica dei luoghi | Restituisce indirizzo, componenti dell'indirizzo e tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica dei luoghi. | |
| 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 relativa alla ricerca di destinazioni. |
Canali della fase di lancio
La versione 4 dell'API Geocoding ha canali separati per le funzionalità GA, Anteprima e Sperimentale. Se vuoi utilizzare le funzionalità Anteprima o Sperimentale, assicurati di specificare il canale corretto nella richiesta. Ad esempio, per accedere alle funzionalità dell'endpoint Destinazioni in Sperimentale, 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 ulteriori informazioni 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 di destinazioni
La v4 introduce un metodo di ricerca di 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 di 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 servizio di 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.
Aggiunto il 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 per le maschere di campo
Utilizza le maschere di campo per specificare le informazioni che la risposta deve restituire. Per i metodi Geocodifica un indirizzo, Geocodifica una località e Geocodifica dei luoghi, tutti i campi dell'oggetto di risposta vengono restituiti per impostazione predefinita. 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 del 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 ulteriori dettagli sui pattern di implementazione sicuri e sulle alternative per le esigenze lato client, consulta Considerazioni sulla sicurezza.