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 segnaposto 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 insieme ai dati restituiti da ciascun metodo.
| 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. |
|
| Geocodifica inversa | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica inversa. | |
| Geocoding dei luoghi | Restituisce l'indirizzo, i componenti dell'indirizzo e i tipi di indirizzo. Consulta la documentazione relativa alla risposta di geocodifica del luogo. | |
| Ricerca della destinazione | 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à.
Metodo di ricerca della destinazione
La v4 introduce un metodo di ricerca delle destinazioni che consente di recuperare informazioni dettagliate su varie destinazioni in base a diversi criteri di input, ad esempio 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 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 API standard 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 i metodi Geocodifica di un indirizzo, Geocodifica di una località e Geocodifica di un luogo, tutti i campi nell'oggetto risposta vengono restituiti per impostazione predefinita. Per il metodo 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 $.
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, in quanto le limitazioni 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 backend. Per ulteriori dettagli su pattern di implementazione sicuri e alternative per le esigenze lato client, consulta Considerazioni sulla sicurezza.
Feedback
Questa è una funzionalità in anteprima. Apprezziamo il tuo feedback all'indirizzo geocoding-feedback-channel@google.com.