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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

Configurare l'API Geocoding

Sviluppatori dello Spazio economico europeo (SEE)

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

Assicurati di soddisfare i prerequisiti.

Abilita l'API nel tuo progetto Google Cloud.

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

I prodotti Google Maps Platform sono protetti dall'utilizzo non autorizzato richiedendo che le chiamate API includano una chiave API o un token OAuth.

Crea un token OAuth

L'API Geocoding 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.

Questo documento descrive come passare un token OAuth alla chiamata dell'API Geocoding nel tuo ambiente di sviluppo. Per istruzioni sull'utilizzo di OAuth in un ambiente di produzione, consulta Metodi di autenticazione di Google.

Informazioni su OAuth

Esistono molti modi per creare e gestire i token di accesso con OAuth in base all'ambiente di deployment.

Ad esempio, il sistema Google OAuth 2.0 supporta le interazioni server-server, come quelle tra la tua applicazione e un servizio Google. Per questo scenario è necessario un account di servizio, ovvero un account che appartiene alla tua applicazione anziché a un singolo utente finale. La tua applicazione chiama le API di Google per conto dell'account di servizio, quindi gli utenti non sono direttamente coinvolti. Per saperne di più sui metodi di autenticazione, consulta Metodi di autenticazione di Google.

In alternativa, puoi utilizzare l'API Geocoding come parte di un'app mobile per Android o iOS. Per informazioni generali sull'utilizzo di OAuth con l'API Geocoding, incluse informazioni sulla gestione dei token di accesso per diversi ambienti di deployment, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Informazioni sugli ambiti OAuth

Per utilizzare OAuth con l'API Geocoding, al token OAuth deve essere assegnato 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.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.

Inoltre, puoi 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 utilizzato quando si creano token utilizzando gcloud.

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

Se vuoi provare l'API Geocoding utilizzando un token OAuth, ma non hai un ambiente configurato per generare token, puoi utilizzare la procedura descritta in questa sezione per effettuare la chiamata.

Questo esempio descrive come utilizzare il token OAuth fornito da credenziali predefinite dell'applicazione (ADC) per effettuare la chiamata. Per informazioni sull'utilizzo di ADC per chiamare le API di Google utilizzando le librerie client, consulta Autenticarsi utilizzando le librerie client.

Prerequisiti

Prima di poter effettuare una richiesta REST utilizzando ADC, utilizza Google Cloud CLI per fornire le credenziali ad ADC:

Installa e inizializza gcloud CLI.
Esegui il seguente gcloud comando sulla tua macchina locale per creare il tuo file delle credenziali:
```
gcloud auth application-default login
```
Viene visualizzata una schermata di accesso. Dopo aver eseguito l'accesso, le tue credenziali vengono archiviate 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 Google Cloud con la fatturazione abilitata nell' X-Goog-User-Project intestazione.

L'esempio seguente effettua una chiamata all'API Geocoding utilizzando un token OAuth.

Modifica il campo PROJECT_ID per passare l'ID del tuo 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"

Fai clic sull'icona di copia nell'esempio di codice, , per copiare il comando curl.
Incolla il comando in una finestra del terminale ed eseguilo.

La risposta è un oggetto JSON:

Risoluzione dei problemi

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