Utilizzare le chiavi API con l'API Elevation

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

I prodotti Google Maps Platform sono protetti dall'uso non autorizzato limitando le chiamate API a quelle che forniscono le credenziali di autenticazione corrette. Le credenziali sono sotto forma di chiave API, ovvero una stringa alfanumerica univoca che associa l'account di fatturazione Google al progetto e all'API o all'SDK specifico.

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

Prima di iniziare

Prima di iniziare a utilizzare l'API Elevation, è necessario un progetto con un account di fatturazione e l'API Elevation abilitata. Per scoprire di più, consulta 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 > Credentials (Credenziali).

    Vai alla pagina Credenziali

  2. Nella pagina Credenziali, fai clic su Crea credenziali > chiave API.
    Nella finestra di dialogo Chiave API creata viene visualizzata la chiave API appena creata.
  3. Fai clic su Chiudi.
    La nuova chiave API è elencata nella pagina Credenziali in 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 limitandone l'utilizzo alle sole API necessarie per l'applicazione. La limitazione delle chiavi API rafforza la sicurezza della tua applicazione proteggendola dalle richieste ingiustificate. Per ulteriori informazioni, consulta le best practice per la sicurezza delle API.

Per limitare una chiave API:

console

  1. Vai alla pagina Google Maps Platform > Credentials (Credenziali).

    Vai alla pagina Credenziali

  2. Seleziona la chiave API per cui vuoi impostare una limitazione. Viene visualizzata la pagina di proprietà della chiave API.
  3. In Limitazioni principali, imposta le seguenti restrizioni:
    • Restrizioni delle applicazioni:
      1. Per accettare le richieste dall'elenco di indirizzi IP dei server web che fornisci, seleziona Indirizzi IP (web server, cron job ecc.) dall'elenco delle Restrizioni delle applicazioni. Specifica un indirizzo IPv4 o IPv6 o una subnet utilizzando la notazione CIDR (ad es. 192.168.0.0/22). Poiché una richiesta di un servizio web del servizio web verifica e confronta l'indirizzo IP esterno con la limitazione della chiave API, utilizza l'indirizzo IP pubblico del server.
    • Restrizioni delle API:
      1. Fai clic su Limita la chiave.
      2. Seleziona API Elevation dal menu a discesa Seleziona API. Se l'API Elevation non è presente nell'elenco, devi attivarla.
  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 sulla chiave esistente.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api_target="elevation-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 in ogni richiesta dell'API Elevation. Nell'esempio seguente, sostituisci YOUR_API_KEY con la chiave API.

https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY

Per le richieste che utilizzano una chiave API è necessario HTTPS.