Prima di iniziare
Per iniziare a utilizzare l'SDK Maps per Android, è necessario un progetto con un account di fatturazione e l'SDK Maps per Android abilitato. Per saperne di più, consulta la pagina 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
-
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 API appena creata. -
Fai clic su Chiudi.
La nuova chiave API è indicata nella pagina Credenziali nella sezione 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 limitandole al solo utilizzo delle API necessarie per l'applicazione. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola dalle richieste ingiustificate. Per scoprire di più, consulta le best practice per la sicurezza delle API.
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 in fase di test e con altro codice non di produzione. Non tentare di pubblicare un'app firmata con un certificato di debug. Gli strumenti dell'SDK Android generano automaticamente questo certificato quando esegui una build di debug.
- Release del certificato: utilizza questo certificato quando vuoi rilasciare l'app in uno store. Gli strumenti dell'SDK Android generano questo certificato quando esegui una build di release.
Per maggiori 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 di seguito:
- Se usi la firma dell'app di Google Play, consulta Collaborare con i provider di API.
- Se gestisci la tua chiave di firma, consulta Autofirmare la tua applicazione o consulta le istruzioni per l'ambiente di build.
Per limitare una chiave API:
Console
-
Vai alla pagina Google Maps Platform > Credenziali.
- Seleziona la chiave API per cui vuoi impostare una limitazione. Viene visualizzata la pagina della proprietà della chiave API.
- In Limitazioni chiave, imposta le seguenti limitazioni:
- Restrizioni delle applicazioni:
- Seleziona App Android.
- Fai clic su + Aggiungi il nome del pacchetto e l'impronta.
- 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:
- Fai clic su Limita chiave.
- Seleziona SDK Maps per Android dal menu a discesa Seleziona API. Se l'SDK Maps per Android non è presente nell'elenco, devi attivarlo.
- 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 per la chiave esistente.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="maps-android-backend.googleapis.com"
--allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Scopri di più su Google Cloud SDK, Installazione di Cloud SDK e sui seguenti comandi:
Passaggi successivi
Ora che hai una chiave API, crea e configura un progetto come descritto in Configurare un progetto Android Studio.