Richiesta di una chiave API

Seleziona la piattaforma: Android iOS JavaScript

Ora che hai configurato la fatturazione e un progetto, attivato l'SDK e installato il gestore delle dipendenze preferito e altro software, puoi creare, aggiungere e limitare la tua chiave API.

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

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 è 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:

• gcloud alpha services api-keys create

Questa chiave API è necessaria al momento della creazione del progetto Xcode come descritto in Configurare un progetto Xcode.

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

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 applichi restrizioni a una chiave API nella console Cloud, le limitazioni delle applicazioni sostituiscono tutte le API abilitate nella sezione 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 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 Limitazioni chiave, imposta le seguenti limitazioni:
• Restrizioni delle applicazioni:
1. Seleziona App per iOS.
2. Per accettare le richieste dall'app per iOS con l'identificatore bundle fornito, seleziona l'identificatore bundle iOS appropriato dall'elenco.
• Restrizioni delle API:
1. Fai clic su Limita chiave.
2. Seleziona SDK Maps per iOS dal menu a discesa Seleziona API. Se l'SDK Maps per iOS non è presente nell'elenco, devi abilitarlo.
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 restrizioni per la chiave esistente.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

Scopri di più su Google Cloud SDK, 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

Ora che hai ricevuto la chiave API per l'SDK Maps per iOS, puoi iniziare.

Passaggi successivi

Ora che hai una chiave API, crea e configura il tuo progetto Xcode come descritto in Configurare un progetto Xcode.