I metodi dell'API Geocoding v4 hanno una quota predefinita di 25 query al secondo (QPS). Per informazioni su come richiedere una quota più elevata, vedi Visualizza e gestisci le quote e seleziona API Geocoding come servizio.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configurare l'API Geocoding

Sviluppatori dello Spazio economico europeo (SEE)

Questo documento descrive i passaggi necessari per iniziare a utilizzare l'API Geocoding.

Verifica di soddisfare i prerequisiti.

Attiva l'API nel tuo progetto Google Cloud.

Configura una chiave API o OAuth per effettuare una richiesta API autenticata.

I prodotti Google Maps Platform richiedono che le chiamate API includano una chiave API o un token OAuth per impedire l'utilizzo non autorizzato. Puoi scegliere la procedura di configurazione corrispondente al tuo ambiente di deployment.

Crea un token OAuth

L'API Geocoding supporta OAuth 2.0 per l'autenticazione. Google supporta scenari OAuth 2.0 comuni, ad esempio per un server web.

Questo documento descrive come passare un token OAuth a una chiamata API Geocoding nel tuo ambiente di sviluppo. Per saperne di più sull'utilizzo di OAuth in un ambiente di produzione, consulta Metodi di autenticazione di Google.

Puoi chiamare le API di Google Maps direttamente inviando richieste API al server oppure puoi utilizzare le librerie client per semplificare il codice. Google Maps fornisce librerie client per Go, Java, Node.js e Python. Per saperne di più, consulta Librerie client dell'API Geocoding.

Panoramica di OAuth

Puoi creare e gestire i token di accesso con OAuth in diversi modi, a seconda dell'ambiente di deployment.

Puoi utilizzare OAuth 2.0 per le interazioni server-to-server tra la tua applicazione e un servizio Google. Per questo scenario, utilizzi un service account associato alla tua applicazione anziché a un singolo utente. Puoi effettuare richieste API utilizzando il service account senza coinvolgere direttamente gli utenti. Per saperne di più sui metodi di autenticazione, consulta Metodi di autenticazione di Google.

In alternativa, puoi integrare l'API Geocoding in un'app mobile Android o iOS. Per ulteriori informazioni sull'utilizzo di OAuth e sulla gestione dei token di accesso per diversi ambienti di deployment, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Ambiti OAuth

Per utilizzare OAuth con l'API Geocoding, devi assegnare al token OAuth l'ambito corretto. L'API Geocoding supporta i seguenti ambiti:

https://www.googleapis.com/auth/maps-platform.geocode: da utilizzare con tutti i metodi dell'API Geocoding.
https://www.googleapis.com/auth/maps-platform.destinations: da utilizzare solo con SearchDestinations per le query di destinazione e arrivo.
https://www.googleapis.com/auth/maps-platform.geocode.address: da utilizzare solo con GeocodeAddress per la geocodifica diretta.
https://www.googleapis.com/auth/maps-platform.geocode.location: da utilizzare solo con GeocodeLocation per la geocodifica inversa.
https://www.googleapis.com/auth/maps-platform.geocode.place: da utilizzare solo con GeocodePlace per la geocodifica dei luoghi.

Puoi anche utilizzare l'ambito generale https://www.googleapis.com/auth/cloud-platform per tutti i metodi dell'API Geocoding. Questo ambito è utile durante lo sviluppo perché è l'ambito predefinito quando crei token con l'interfaccia a riga di comando gcloud.

Esempio: prova le chiamate API REST nel tuo ambiente di sviluppo locale

Se non hai un ambiente che genera token e vuoi provare l'API Geocoding con un token OAuth, utilizza la procedura descritta in questa sezione.

Questo esempio descrive come utilizzare il token OAuth fornito dalle Credenziali predefinite dell'applicazione (ADC) per effettuare la chiamata. Per saperne di più sull'utilizzo di ADC per chiamare le API di Google con le librerie client, consulta Autenticati utilizzando le librerie client.

Utilizza la seguente procedura REST solo per lo sviluppo o i test, non per la produzione.

Prerequisiti

Prima di effettuare una richiesta REST utilizzando ADC, utilizza l'interfaccia a riga di comando gcloud per fornire le credenziali ad ADC:

Installa e inizializza l'interfaccia a riga di comando gcloud. Per saperne di più, consulta Installa gcloud CLI.
Esegui l'autenticazione con l'interfaccia a riga di comando gcloud:
```
gcloud auth application-default login
```
Completa la procedura di accesso per salvare le tue credenziali nel file delle credenziali locali utilizzato da ADC.

Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

Effettua una richiesta REST

In questo esempio, passi due intestazioni della richiesta:

Passa il token OAuth nell'intestazione Authorization utilizzando il seguente comando per generare il token:

gcloud auth application-default print-access-token

Il token restituito ha un ambito di https://www.googleapis.com/auth/cloud-platform.
Passa l'ID o il nome del tuo progetto cloud Google Cloud con la fatturazione abilitata nell'intestazione X-Goog-User-Project.

Per chiamare l'API Geocoding utilizzando un token OAuth, completa i seguenti passaggi:

Nel seguente esempio di codice, sostituisci PROJECT_ID con l'ID progetto Google Cloud:

curl -X GET -H 'Content-Type: application/json' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"

Per copiare il comando curl, fai clic su Copia nell'esempio di codice.
Incolla il comando in una finestra del terminale, quindi eseguilo.

Risoluzione dei problemi

Se la richiesta restituisce un messaggio di errore che indica che questa API non supporta le credenziali dell'utente finale, consulta Risolvi i problemi di configurazione di ADC.