Ottenere una chiave API

Seleziona la piattaforma: Android iOS JavaScript

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

Creazione di chiavi API

La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto ai fini di utilizzo e 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.
    Nella finestra di dialogo Chiave API creata viene visualizzata 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:

Ti serve questa chiave API quando crei il tuo progetto Xcode, come descritto in Configurare un progetto Xcode.

Limitazione delle chiavi API

Google consiglia vivamente di limitare le chiavi API limitandone l'utilizzo alle sole API necessarie per l'applicazione. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola da richieste ingiustificate. Per ulteriori informazioni, consulta le best practice per la sicurezza delle API.

Per limitare una chiave API:

Console

  1. Vai alla pagina 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. Seleziona App per iOS.
      2. Per accettare le richieste dall'app per iOS con l'identificatore pacchetto da te fornito, seleziona l'identificatore pacchetto iOS appropriato dall'elenco.
    • Restrizioni delle API:
      1. Fai clic su Limita chiave.
      2. Seleziona Maps SDK for iOS dal menu a discesa Seleziona API. Se Maps SDK for iOS non è presente nell'elenco, devi enable.
  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 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="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:

Ora che hai ottenuto la chiave API per Maps SDK for iOS, puoi iniziare.

Passaggi successivi

Ora che disponi di una chiave API, crea e configura il progetto Xcode come descritto in Impostare un progetto Xcode.