Guida introduttiva a Google Maps Platform

Questa pagina illustra i passaggi di base necessari per iniziare a utilizzare una qualsiasi delle API e degli SDK su Google Maps Platform.

Guida rapida

Se non hai mai utilizzato la console Google Cloud per creare un account di fatturazione o un progetto, fai clic sul pulsante Inizia che rimanda a un'esperienza di configurazione interattiva nella console Cloud per i nuovi utenti:

Inizia

In alternativa, puoi completare i seguenti passaggi di configurazione obbligatori:

Passaggio 1: configura il progetto

Console

  1. Nella console Google Cloud, nella pagina di selezione del progetto, fai clic su Crea progetto per iniziare a creare un nuovo progetto Cloud.

    Vai alla pagina del selettore dei progetti

  2. Verifica che la fatturazione sia attivata per il tuo progetto Cloud. Verifica che la fatturazione sia abilitata per il tuo progetto.

    Google Cloud offre una prova senza costi. La prova scade dopo 90 giorni o dopo che l'account ha accumulato addebiti per un valore di 300 $, a seconda dell'evento che si verifica per primo. Annulla in qualsiasi momento. Per ulteriori informazioni, consulta Crediti dell'account di fatturazione e Fatturazione.

Cloud SDK

gcloud projects create "PROJECT"

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

Passaggio 2: abilita le API o gli SDK

Per utilizzare Google Maps Platform, devi abilitare le API o gli SDK che prevedi di utilizzare con il tuo progetto.

Tieni presente che alcune integrazioni richiedono l'abilitazione di più API/SDK. Se non sai con certezza quali API o SDK abilitare, prova a utilizzare Capabilities Explorer o consulta la documentazione relativa all'API o all'SDK che vuoi utilizzare.

Per abilitare una o più API o SDK:

Console

  1. Per visualizzare le API e gli SDK di Google Maps Platform che puoi abilitare, vai alla pagina della libreria delle API di Google Maps nella console Cloud:

    Vai alla pagina della libreria API di Google Maps

  2. Fai clic sull'API o sull'SDK che vuoi abilitare.
    • Se il pulsante indica ABILITA, fai clic per abilitare l'API o l'SDK.
    • Se il pulsante indica GESTISCI, l'API o l'SDK è già abilitato e non devi fare altro.
    • Se fai clic su uno dei pulsanti, viene visualizzata la dashboard per l'API o l'SDK. (Fai clic sul pulsante DISABILITA per rimuovere l'API o l'SDK da questo progetto.)

Cloud SDK

Il seguente comando abilita tutte le API di Maps, Routes e Places:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

Utilizza questo comando per abilitare le API Environment:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Passaggio 3: ottieni una chiave API

Questo passaggio illustra solo la procedura di creazione della chiave API. Se utilizzi la chiave API in produzione, ti consigliamo vivamente di limitarla. Puoi trovare ulteriori informazioni nella pagina Utilizzo delle chiavi API specifica per il prodotto.

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 le API che prevedi di utilizzare rimangano selezionate.
      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 le API che prevedi di utilizzare.
      3. Fai clic su Salva.

    La selezione di un'API qui non la abilita. Assicurati che ogni API che selezioni sia abilitata nella 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.

Cloud SDK

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. Sostituisci SERVICE_NAME con il nome del servizio di un'API che prevedi di utilizzare, ad esempio places.googleapis.com. Per consentire più API, ripeti il flag --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    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. Sostituisci SERVICE_NAME con il nome del servizio dell'API da aggiungere. 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=SERVICE_NAME

    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".

Crediti dell'account di fatturazione

  • Se non sei mai stato un cliente pagante di Google Cloud, Google Maps Platform o Firebase e non hai mai effettuato la registrazione alla prova senza costi di Google Cloud, hai diritto alla prova senza costi e al credito di benvenuto di 300 $, che puoi spendere per i servizi di Google Maps Platform.
  • Ogni SKU di Google Maps Platform fornisce una quantità specifica di utilizzo mensile senza costi, mostrata nel listino prezzi e descritta nella sezione Fatturazione di Google Maps Platform.
  • Google fornisce anche crediti per programmi pubblici, come organizzazioni non profit, startup, Crisis Response, testate giornalistiche, istruzione e aziende di trasporto pubblico.

Passaggi successivi

Una volta completata la configurazione, puoi iniziare a utilizzare le API e gli SDK di Google Maps Platform. Per saperne di più, consulta la Guida introduttiva, quella Panoramica e quella per gli sviluppatori per informazioni sull'API o sull'SDK di tuo interesse. Le API e gli SDK sono elencati nella documentazione di Google Maps Platform (per prodotto) e nelle API Google Maps Platform (per piattaforma).