Utilizzare le chiavi API con l'API Geocoding

I prodotti di Google Maps Platform sono protetti da un uso non autorizzato limitando le chiamate API a quelle che forniscono le credenziali di autenticazione corrette. Queste credenziali sono sotto forma di chiave API, una stringa alfanumerica univoca che associa il tuo account di fatturazione Google al tuo progetto e all'API o all'SDK specifici.

Questa guida mostra come creare, limitare e utilizzare la chiave API per Google Maps Platform.

Prima di iniziare

Prima di iniziare a utilizzare l'API Geocoding, devi disporre di un progetto con un account di fatturazione e dell'API Geocoding abilitata. Per saperne di più, consulta la pagina Configurare Cloud Console.

Creazione di chiavi API

La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto ai fini dell'utilizzo e della fatturazione. Devi avere almeno una chiave API associata al tuo progetto.

Per creare una chiave API:

Console

  1. Vai alla pagina Google Maps Platform > Credenziali.

    Vai alla pagina Credenziali

  2. Nella pagina Credenziali, fai clic su Crea credenziali > Chiave API.
    La finestra di dialogo Chiave API creata mostra la chiave API appena creata.
  3. Fai clic su Chiudi.
    La nuova chiave API è indicata nella pagina Credenziali nella sezione Chiavi API.
    (Ricorda di limitare la chiave API prima di utilizzarla in produzione.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Scopri di più su Google Cloud SDK, Installazione di Cloud SDK e sui seguenti comandi:

Limitazione delle chiavi API

Google consiglia vivamente di limitare le chiavi API limitandole al solo utilizzo delle API necessarie per l'applicazione. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola dalle richieste ingiustificate. Per scoprire di più, consulta le best practice per la sicurezza delle API.

Per limitare una chiave API:

Console

  1. Vai alla pagina Google Maps Platform > Credenziali.

    Vai alla pagina Credenziali

  2. Seleziona la chiave API per cui vuoi impostare una limitazione. Viene visualizzata la pagina della proprietà della chiave API.
  3. In Limitazioni chiave, imposta le seguenti limitazioni:
    • Restrizioni delle applicazioni:
      1. Per accettare le richieste dall'elenco di indirizzi IP dei server web da te forniti, seleziona Indirizzi IP (server web, cron job ecc.) dall'elenco di Limitazioni delle applicazioni. Specifica uno o più indirizzi IPv4 o IPv6 oppure una subnet utilizzando la notazione CIDR. Gli indirizzi IP devono corrispondere a quelli osservati dai server di Google Maps Platform. Se utilizzi la Network Translation (NAT), di solito corrisponde all'indirizzo IP pubblico della macchina.
    • Restrizioni delle API:
      1. Fai clic su Limita chiave.
      2. Seleziona API Geocoding dal menu a discesa Seleziona API. Se l'API Geocoding non è presente nell'elenco, devi abilitarla.
  4. Per finalizzare le modifiche, fai clic su Salva.

Cloud SDK

Elenca le chiavi esistenti. 

gcloud services api-keys list --project="PROJECT"

Cancella le limitazioni esistenti sulla chiave esistente. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Imposta nuove restrizioni per la chiave esistente. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="geocoding-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

Scopri di più su Google Cloud SDK, Installazione di Cloud SDK e sui seguenti comandi:

Aggiunta della chiave API alla richiesta

Devi includere una chiave API con ogni richiesta API Geocoding. Nell'esempio seguente, sostituisci YOUR_API_KEY con la tua chiave API.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

HTTPS è obbligatorio per le richieste che utilizzano una chiave API.