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.
L'API Geocoding v4 fornisce sia intelligence iperlocale su destinazione e arrivo sia risoluzione di base da coordinate a indirizzo. Che tu stia creando un'esperienza di consegna last-mile, di car sharing o di navigazione passo passo o che tu stia normalizzando gli indirizzi in coordinate, la versione 4 offre endpoint dedicati su misura per il tuo caso d'uso.
Non sai quale endpoint è adatto alla tua applicazione? Consulta Scegli un metodo di geocodifica.
Cosa puoi fare con l'API Geocoding
L'API Geocoding v4 include le seguenti funzionalità ed endpoint:
- Cerca destinazioni: recupera i dettagli di arrivo iperlocali per una destinazione da un indirizzo, un ID luogo o delle coordinate, inclusi gli ingressi degli edifici, i token dei punti di navigazione instradabili, i contorni degli edifici e dei terreni, le sottodestinazioni e i punti di riferimento nelle vicinanze.
- Geocodifica un indirizzo: converti le vie in coordinate geografiche e ID luogo (geocodifica normale).
- Geocodifica una località: converti le coordinate di latitudine e longitudine in indirizzi o aree amministrative leggibili (geocodifica inversa).
- Geocodifica un luogo: recupera i dettagli dell'indirizzo formattato e le coordinate per un ID luogo di Google Maps noto.
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 v4 supporta la ricerca della destinazione insieme alla geocodifica di base:
- Ricerca della destinazione (
SearchDestinations): risolve un indirizzo, un ID luogo o una coppia di coordinate in un oggettoDestinationcompleto. Utilizza questo metodo quando l'arrivo fisico è importante, ad esempio per identificare gli ingressi preferiti degli edifici, indirizzare i conducenti ai punti di ritiro o di consegna designati utilizzando i token dei punti di navigazione, visualizzare i perimetri degli edifici su una mappa o navigare in complessi con più edifici. - Geocodifica di base: esegue la conversione tra indirizzi, coordinate e ID luogo:
- Geocodifica: converte indirizzi come "1600 Amphitheatre Parkway, Mountain View, CA" in coordinate di latitudine e longitudine o ID luogo per posizionare gli indicatori sulla mappa o centrare il frame di visualizzazione della mappa.
- Geocodifica inversa: converte le coordinate di latitudine e longitudine o gli ID luogo in indirizzi leggibili per i segnaposto della mappa inseriti dagli utenti, i selettori di località o la visualizzazione dell'interfaccia utente.
- Geocodifica dei luoghi: recupera i dettagli dell'indirizzo e le coordinate di un ID luogo di Google Maps noto.
La tabella seguente riassume le risorse disponibili tramite l'API Geocoding v4, insieme ai dati restituiti da ciascun metodo:
| Risorse di dati | Dati restituiti | Formato di reso |
|---|---|---|
| Cerca destinazioni ( POST /v4/geocode/destinations)
|
Restituisce informazioni iperlocali sull'arrivo: poligoni di edifici e terreni (displayPolygon), entrances fisici, navigationPoints instradabili (con token), containingPlaces e subDestinations gerarchici, landmarks relazionali e Place Details principali. Consulta la sezione Cerca destinazioni.
|
|
| Geocodifica un indirizzo ( GET /v4/geocode/address)
|
Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Risposta di geocodifica. | |
| Geocodifica una località ( GET /v4/geocode/location)
|
Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la sezione Risposta di geocodifica inversa. | |
| Geocodifica un luogo ( GET /v4/geocode/places)
|
Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta Risposta di geocodifica di un luogo. |
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.