Utilizza le chiavi API con l'API Distance Matrix (legacy)

Google protegge i prodotti Google Maps Platform dall'utilizzo non autorizzato limitando le chiamate API a quelle che forniscono credenziali di autenticazione appropriate. Queste credenziali sono sotto forma di chiave API, ovvero una stringa alfanumerica univoca che associa il tuo account di fatturazione Cloud 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 Distance Matrix (Legacy), devi avere un progetto con un account di fatturazione e l'API Distance Matrix (Legacy) abilitata. Per saperne di più, consulta Configura nella console Cloud.

Crea 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 tuo progetto. Per creare una nuova chiave o aggiungere un'API o un SDK a una chiave esistente, segui queste istruzioni.

Console

  1. Vai alla pagina Google Maps Platform > Chiavi e credenziali.

    Vai alla pagina Chiavi e credenziali

  2. Se richiesto, seleziona il progetto.

  3. Procedi in uno dei seguenti modi:

    • Crea una nuova chiave:

      1. Fai clic su Crea credenziali > Chiave API.
      2. Nel riquadro Crea chiave API, apri l'elenco Seleziona limitazioni dell'API.
      3. Cancella tutte le API che non sono necessarie per questa chiave e assicurati che l'API Distance Matrix rimanga selezionata.
      4. Fai clic su Crea. Nel riquadro viene visualizzata la nuova chiave API.

    • Utilizza una chiave esistente:

      1. Fai clic sul nome della chiave.
      2. Nell'elenco Seleziona limitazioni dell'API, seleziona API Distance Matrix.
      3. Fai clic su Salva.

    La selezione di un'API qui non la abilita. Assicurati che l'API Distance Matrix sia abilitata nella relativa pagina della libreria API.

  4. Per visualizzare la stringa della chiave in un secondo momento, vai alla pagina Chiavi e credenziali e fai clic su Mostra chiave per la chiave.

Se la console ha un aspetto diverso da questi passaggi, consulta Crea una chiave API e Aggiungi limitazioni API nella documentazione di Google Cloud.

gcloud

Sostituisci PROJECT_ID con l'ID progetto nei comandi seguenti.

  • Crea una nuova chiave: esegui il comando seguente e sostituisci DISPLAY_NAME con un nome per la chiave. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=distance-matrix-backend.googleapis.com

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

  • Utilizza una chiave esistente: esegui il comando seguente e sostituisci KEY_ID con l'ID della chiave. Il flag --append mantiene le API già consentite dalla chiave. In caso contrario, il comando le sostituisce.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=distance-matrix-backend.googleapis.com

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

    L'ID chiave non è la stringa della chiave o il nome visualizzato. Per trovarlo, esegui gcloud services api-keys list --project="PROJECT_ID". L'ID è l'ultima parte del campo name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Per visualizzare la stringa della chiave, esegui gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Limita le chiavi API

Google consiglia vivamente di limitare l'utilizzo delle chiavi API solo alle API necessarie per la tua applicazione. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola da richieste ingiustificate. Sei responsabile finanziariamente degli addebiti causati dall'abuso di chiavi API senza limitazioni. Per saperne di più, consulta le best practice per la sicurezza delle API.

Per limitare una chiave API:

Console

  1. Vai alla pagina Google Maps Platform > Chiavi e credenziali.

    Vai alla pagina Chiavi e credenziali

  2. Seleziona la chiave API su cui vuoi impostare una limitazione. Viene visualizzata la pagina delle proprietà della chiave API.
  3. In Restrizioni relative alle chiavi, imposta le seguenti restrizioni:
    • Restrizioni delle applicazioni:
      1. Per accettare le richieste dall'elenco di indirizzi IP del server web che fornisci, seleziona Indirizzi IP in Restrizioni delle applicazioni. Specifica uno o più indirizzi IPv4 o IPv6 oppure una subnet utilizzando la notazione CIDR. Gli indirizzi IP devono corrispondere all'indirizzo di origine osservato dai server di Google Maps Platform. Se utilizzi la Network Address Translation (NAT), in genere corrisponde all'indirizzo IP pubblico della tua macchina.
    • Restrizioni delle API:
      1. In Seleziona limitazioni dell'API, assicurati che l'opzione API Distance Matrix sia selezionata. Se non è presente nell'elenco, devi abilitarla.
  4. Per finalizzare le modifiche, fai clic su Salva.

gcloud

Esegui questo comando. Sostituisci KEY_ID con l'ID della chiave e PROJECT_ID con l'ID progetto. Per trovare l'ID chiave, esegui gcloud services api-keys list --project="PROJECT_ID". L'ID è l'ultima parte del campo name.

gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=distance-matrix-backend.googleapis.com \
    --allowed-ips="IP_ADDRESS"

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

Aggiungi la chiave API alla richiesta

Devi includere una chiave API in ogni richiesta dell'API Distance Matrix (Legacy). Nell'esempio seguente, sostituisci YOUR_API_KEY con la tua chiave API:

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key=YOUR_API_KEY

Devi utilizzare HTTPS per le richieste che utilizzano una chiave API.