I prodotti Google Maps Platform sono protetti dall'uso non autorizzato attraverso la limitazione delle chiamate API a quelli che forniscono le credenziali di autenticazione appropriate. Si tratta di credenziali sotto forma di Una chiave API, una stringa alfanumerica univoca che associa il tuo account di fatturazione Google al tuo progetto e con l'API o l'SDK specifici.
Questa guida illustra come creare, limitare e utilizzare la tua chiave API per Google Maps Platform.
Creazione di chiavi API
La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto per per scopi di utilizzo e fatturazione. Devi avere almeno una chiave API associata al tuo progetto.
Per creare una chiave API:
Console
-
Vai a Google Maps Platform > Credenziali.
-
Nella pagina Credenziali, fai clic su Crea credenziali > chiave API.
Nella finestra di dialogo Chiave API creata viene visualizzata la chiave API appena creata. -
Fai clic su Chiudi.
La nuova chiave API è indicata nella pagina Credenziali, nella sezione Chiavi API.
Ricordati di limitare l'API prima di utilizzarla in produzione).
Cloud SDK
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
Scopri di più sugli SDK Google Cloud , Installazione di Cloud SDK e i seguenti comandi:
Limitazione delle chiavi API
Google consiglia vivamente di limitare le chiavi API limitandone l'utilizzo alle sole chiavi le API necessarie per la tua applicazione. La limitazione delle chiavi API rafforza la sicurezza dell'applicazione per proteggerlo da richieste ingiustificate. Per ulteriori informazioni, vedi Best practice per la sicurezza delle API.
Per limitare una chiave API:
Console
-
Vai a Google Maps Platform > Credenziali.
- Seleziona la chiave API per la quale vuoi impostare una limitazione. Viene visualizzata la pagina delle proprietà della chiave API.
- In Limitazioni delle chiavi, imposta le seguenti restrizioni:
- Restrizioni delle applicazioni:
- Per accettare richieste dall'elenco di indirizzi IP del server web che fornisci, seleziona Indirizzi IP (server web, cron job, ecc.) nell'elenco dei Restrizioni delle applicazioni. Specifica uno o più indirizzi IPv4 o IPv6, o una subnet utilizzando la notazione CIDR. Gli indirizzi IP devono corrispondere all'indirizzo di origine Osservazione dei server di Google Maps Platform. Se utilizzi rete Address Translation (NAT), corrisponde in genere all'indirizzo IP pubblico della tua macchina.
- Restrizioni delle API:
- Fai clic su Limita chiave.
- Seleziona API Map Tiles dal menu a discesa Seleziona API. Se l'API Map Tiles non è elencata, devi attivala.
- 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 per la chiave esistente.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--clear-restrictions
Imposta nuove limitazioni per la chiave esistente.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="tile.googleapis.com"
--allowed-ips="IP_ADDRESS"
Scopri di più sugli SDK Google Cloud , Installazione di Cloud SDK e i seguenti comandi:
Aggiunta della chiave API alla richiesta
Devi includere una chiave API in ogni richiesta API Map Tiles. Nell'esempio seguente,
sostituisci YOUR_API_KEY con la tua chiave API.
https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY
HTTPS è richiesto per le richieste che utilizzano una chiave API.
Passaggi successivi
Ottieni riquadri 2D
Dopo aver ottenuto la chiave API, puoi utilizzarla per creare un token di sessione. Utilizzerai quindi sia la chiave API sia il token di sessione nelle richieste di riquadri di mappe 2D e riquadri Street View.
Utilizzare i token di sessione
Ottieni riquadri 3D
Dopo aver ottenuto la chiave API, puoi utilizzarla per visualizzare i riquadri 3D.