I prodotti Google Maps Platform sono protetti dall'utilizzo non autorizzato limitando le chiamate API a quelle che forniscono credenziali di autenticazione appropriate. Queste credenziali assumono la forma di una chiave API, ovvero una stringa alfanumerica univoca che associa il tuo account di fatturazione Google al tuo progetto e all'API o all'SDK specifico.
Scopri come creare, limitare e utilizzare la tua chiave API per Google Maps Platform.
Prima di iniziare
Prima di iniziare a utilizzare l'API Directions (Legacy), devi avere un progetto con un account di fatturazione e l'API Directions (Legacy) abilitata. Per saperne di più, consulta Configura nella console Cloud.
Crea chiavi API
La chiave API è un identificatore univoco che autentica le richieste associate al progetto a fini di utilizzo e fatturazione. Devi avere almeno una chiave API associata al tuo progetto.
Per creare una chiave API:
Console
-
Vai alla pagina Google Maps Platform > Credenziali.
-
Nella pagina Credenziali, fai clic su Crea credenziali > Chiave API.
La finestra di dialogo Chiave API creata mostra la chiave appena creata. -
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 services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Scopri di più su Google Cloud SDK , installazione di Cloud SDK e i seguenti comandi:
Limita le chiavi API
Google consiglia vivamente di limitare le chiavi API limitandone l'utilizzo solo alle API necessarie per la tua applicazione. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola da richieste ingiustificate. Sei responsabile finanziariamente degli addebiti causati dall'abuso di chiavi API senza limitazioni. Per saperne di più, consulta le best practice per la sicurezza delle API.
Per limitare una chiave API:
Console
-
Vai alla pagina Google Maps Platform > Credenziali.
- Seleziona la chiave API su cui vuoi impostare una limitazione. Viene visualizzata la pagina delle proprietà della chiave API.
- In Restrizioni relative alle chiavi, imposta le seguenti restrizioni:
- Restrizioni delle applicazioni:
- Per accettare le richieste dall'elenco di indirizzi IP dei server web che fornisci, seleziona Indirizzi IP (server web, cron job ecc.) dall'elenco di Restrizioni delle applicazioni. Specifica uno o più indirizzi IPv4 o IPv6 oppure una subnet utilizzando la notazione CIDR. Gli indirizzi IP devono corrispondere all'indirizzo di origine osservato dai server di Google Maps Platform. Se utilizzi la Network Address Translation (NAT), in genere corrisponde all'indirizzo IP pubblico della tua macchina.
- Restrizioni delle API:
- Fai clic su Limita chiave.
- Seleziona API Directions (Legacy) dal menu a discesa Seleziona API. Se l'API Directions (Legacy) non è presente nell'elenco, devi abilitarla.
- 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 services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Imposta nuove restrizioni sulla chiave esistente.
gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \ --api-target=service=directions-backend.googleapis.com --allowed-ips="IP_ADDRESS"
Scopri di più su Google Cloud SDK , installazione di Cloud SDK e i seguenti comandi:
Aggiungi la chiave API alla richiesta
Devi includere una chiave API in ogni richiesta di API Directions (Legacy). Nell'esempio seguente, sostituisci YOUR_API_KEY con la tua chiave API:
https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY
Per le richieste che utilizzano una chiave API, devi utilizzare HTTPS.