Utilizza le chiavi API con l'API Places

Seleziona la piattaforma: Android iOS JavaScript Servizio web

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

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 Places, devi avere un progetto con un account di fatturazione e API Places abilitata. Per scoprire di più, consulta Configurazione in Cloud Console.

Creazione di chiavi API

Nota: se utilizzi sia l'API Places sia l'API Places esistenti (Novità), ti consigliamo di creare una chiave API distinta per ogni versione dell'API. A evitare addebiti accidentali, controlla tutte le altre chiavi API per assicurarti di avere abilitato solo l'API Places o l'API Places (nuova) sulle chiavi in cui necessario.

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 progetto.

Per creare una chiave API:

Console

1. Vai a Google Maps Platform > 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.
   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:

• gcloud alpha services api-keys create

Limitazione delle 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 rafforza la sicurezza dell'applicazione per proteggerlo da richieste ingiustificate. Per saperne di più, consulta le best practice per la sicurezza delle API.

Quando limiti una chiave API in Cloud Console, le limitazioni delle applicazioni sostituiscono le API abilitate in Restrizioni delle API. Segui le best practice creando una chiave API separata per ogni app e per ogni piattaforma su cui è disponibile l'app.

Per limitare una chiave API:

Console

1. Vai a Google Maps Platform > Credenziali.

   Vai alla pagina Credenziali

2. Seleziona la chiave API per la quale vuoi impostare una limitazione. Viene visualizzata la pagina delle proprietà della chiave API.
3. In Limitazioni delle chiavi, 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 (server web, cron job ecc.) dall'elenco di Restrizioni per le 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 rilevato dai server di Google Maps Platform. Se utilizzi rete Address Translation (NAT), corrisponde in genere all'indirizzo IP pubblico della tua macchina.
• Restrizioni delle API:
1. Fai clic su Limita chiave.
2. Seleziona API Places o API Places (nuova) dal menu a discesa Seleziona API, ma non entrambi. Se l'API Places o l'API Places (nuova) non è elencata, devi abilitarla.
   Nota: se utilizzi sia l'API Places esistente sia l'API Places (nuova), ti consigliamo di creare una chiave API separata per ogni versione dell'API.
4. Per finalizzare le modifiche, fai clic su Salva.
   

Cloud SDK

API Places (Novità)

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 sulla chiave esistente.

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

Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

API Places

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 sulla chiave esistente.

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

Scopri di più sugli SDK Google Cloud , Installazione di Cloud SDK e i seguenti comandi:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

Aggiunta della chiave API alla richiesta

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

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=YOUR_API_KEY

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

Nota: quando si utilizzano i servizi web, tutti i caratteri speciali all'interno dei parametri devono avere codifica URL. Gli URL devono essere codificati correttamente per essere validi e sono limitati a 2048 caratteri per tutti i servizi web. Tieni presente questo limite quando crei gli URL. Browser, proxy e server diversi possono avere limiti di caratteri degli URL diversi.