Utilizzo di chiavi API

Seleziona la piattaforma: Android iOS JavaScript

Prima di iniziare

Prima di iniziare a utilizzare Maps SDK for Android, devi avere un progetto con un account di fatturazione e Maps SDK for Android abilitato. Per scoprire di più, consulta Configurazione in Cloud Console.

Creazione di 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 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 è 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, sull'installazione di Cloud SDK e sui seguenti comandi:

• gcloud alpha services api-keys create

Nota: puoi utilizzare la stessa chiave API per le tue app Maps SDK for Android e Places SDK for Android.

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 aggiunge sicurezza alla tua applicazione proteggendola da richieste ingiustificate. Per saperne di più, consulta le best practice per la sicurezza delle API.

Quando limiti una chiave API nella console Cloud, 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.

Quando limiti la chiave API, devi fornire l'impronta del certificato SHA-1 della chiave di firma utilizzata per firmare l'applicazione. Esistono due tipi di certificati:

• Certificato di debug: utilizza questo tipo di certificato solo con le app che stai testando e con altro codice non di produzione. Non tentare di pubblicare un'app firmata con un certificato di debug. Gli strumenti Android SDK generano questo certificato automaticamente quando esegui una compilazione di debug.
• Certificato di rilascio: utilizza questo certificato quando è tutto pronto per rilasciare la tua app in uno store. Gli strumenti Android SDK generano questo certificato quando esegui una release build.

Per ulteriori informazioni sulla firma e sui certificati delle applicazioni Android, consulta la guida Firmare l'app.

Per istruzioni su come trovare l'impronta del certificato di firma, consulta i riferimenti riportati di seguito:

• Se utilizzi la firma dell'app di Google Play, consulta Lavorare con i provider di API.
• Se gestisci la tua chiave di firma, consulta Firma autonomo dell'applicazione oppure fai riferimento alle istruzioni per il tuo ambiente di compilazione.

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 Restrizioni relative alle chiavi, imposta le seguenti limitazioni:
• Restrizioni delle applicazioni:
1. Seleziona App per Android.
2. Fai clic su + Aggiungi nome pacchetto e impronta.
3. Inserisci il nome del pacchetto e l'impronta del certificato SHA-1. Ad esempio:

   com.example.android.mapexample

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

• Restrizioni delle API:
1. Fai clic su Limita chiave.
2. Seleziona Maps SDK for Android dal menu a discesa Seleziona API. Se Maps SDK for Android non è presente nell'elenco, devi attivarlo.
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 limitazioni per la chiave esistente.

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-android-backend.googleapis.com
    --allowed-application=sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME

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

Passaggi successivi

Ora che hai una chiave API, crea e configura un progetto come descritto in Configurare un progetto Android Studio.