Configurazione

Questo prodotto o questa funzionalità è sperimentale (pre-release). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive cosa devi fare per iniziare a creare con l'SDK Maps 3D per Android. La procedura di configurazione prevede la configurazione di un progetto e di un'API Google Cloud per l'utilizzo con l'SDK, quindi la configurazione di un progetto Android Studio. Completa questi passaggi prima di aggiungere la tua prima mappa 3D alla app.

Configura un progetto Google Cloud e una chiave API

Prima di poter iniziare a creare app con l'SDK Maps 3D per Android, devi configurare un progetto Google Cloud e una chiave API da utilizzare con l'SDK Maps 3D per Android completando i seguenti passaggi:

Passaggio 1

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 attivata per il tuo progetto.

   Google Cloud offre una prova senza costi. La prova scade al termine di 90 giorni o dopo che l'account ha accumulato addebiti per un valore di 300 $, a seconda dell'evento che si verifica per primo. Puoi annullare 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:

• gcloud projects create

Nota: se non prevedi di conservare le risorse che crei in un esercizio didattico, crea un progetto anziché selezionarne uno esistente. Al termine dell'esercizio, puoi eliminare il progetto e tutte le relative risorse.

Passaggio 2

Per utilizzare Google Maps Platform, devi attivare 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 il selettore di API o consulta la documentazione dell'API/dell'SDK che vuoi utilizzare.

Per attivare 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 Libreria API Maps nella console Cloud:

   Vai alla pagina Libreria API Maps.

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

Cloud SDK

Il seguente comando abilita tutte le API 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:

• gcloud services enable
• gcloud services disable

Utilizza questo comando per abilitare le API Environment:

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

Nota: l'attivazione dell'API Places attiva anche la libreria Places, l'API Maps JavaScript, l'SDK Places per Android e l'SDK Places per iOS.

Passaggio 3

Questo passaggio riguarda solo la procedura di creazione della chiave API. Se utilizzi la chiave API in produzione, ti consigliamo vivamente di limitarla. Puoi trovare maggiori informazioni nella pagina Utilizzo di chiavi API specifica del 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 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 è elencata nella pagina Credenziali in Chiavi API.
   (Ricorda di limitare la chiave API prima di utilizzarla in produzione.)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

• gcloud services api-keys create

Per attivare l'SDK, consulta la pagina SDK Maps 3D per Android nella console Google Cloud. Per ulteriori informazioni su come completare questi passaggi, consulta la pagina Iniziare a utilizzare Google Maps Platform.

Configurare un progetto Android Studio

Questa sezione spiega come creare e configurare un progetto Android Studio per l'utilizzo con l'SDK Maps 3D per Android.

Parte 1: configura il progetto e la configurazione di Gradle

1. Crea un nuovo progetto Android Studio utilizzando il modello Attività di visualizzazione vuota.

2. Se utilizzi Git per il controllo del codice sorgente, modifica il file .gitignore del progetto per impedire il commit del file dei segreti al controllo della versione:

   • Nella directory principale del progetto, apri il file .gitignore.
   • Aggiungi la seguente riga:

   secrets.properties
   

3. Aggiorna il file build.gradle.kts a livello di progetto:

   • Nella directory principale del progetto, apri il file build.gradle.kts.
   • Nel blocco plugins, aggiungi il plug-in Secrets Gradle:

   plugins {
     alias(libs.plugins.android.application) apply false
     alias(libs.plugins.kotlin.android) apply false
     alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
   }
   

4. Aggiorna il file gradle/libs.versions.toml: - Apri il file gradle/libs.versions.toml, che in genere si trova nella directory gradle all'interno della directory principale del progetto. - Nella sezione delle versioni, aggiungi le versioni per l'SDK e il plug-in Gradle Secrets:

   maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
   secretsGradlePlugin = "2.0.1"
   

   -   In the library section, add the SDK library:
   

   play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
   

   -   In the plugin section, add the Secrets Gradle plugin:
   

   secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }
   

5. Aggiorna il file app/build.gradle.kts a livello di modulo: - Apri il file build.gradle.kts a livello di modulo, che in genere si trova nella directory app. - Nella parte superiore del file, aggiungi il plug-in Secrets Gradle al blocco plugins:

   plugins {
     alias(libs.plugins.android.application)
     alias(libs.plugins.kotlin.android)
     alias(libs.plugins.secrets.gradle.plugin) // Add this line
   }
   

   -   In the `dependencies` block, add the SDK:
   

   dependencies {
     // ... other dependencies
     implementation(libs.play.services.maps3d) // Add this line
   }
   

   -   At the end of the file, outside of the `android` and `dependencies`
       blocks, add the secrets configuration:
   

   secrets {
     // Optionally specify a different filename containing your secrets.
     // The plugin defaults to "local.properties"
     propertiesFileName = "secrets.properties"
   
     // A properties file containing default secret values. This file can be
     // checked in version control.
     defaultPropertiesFileName = "local.defaults.properties"
   }
   

Parte 2: aggiungi la chiave API al progetto

1. Crea un file secrets.properties:

   • Nella directory principale del modulo dell'app (di solito la directory app), crea un nuovo file denominato secrets.properties.
   • Aggiungi la chiave API al file:

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   ``` Note: Make sure you
       replace `YOUR_API_KEY_HERE` with the API key that you configured for use
   with the Maps 3D SDK for Android.
   

2. Crea un file local.defaults.properties: - Nella directory principale del modulo dell'app, crea un nuovo file denominato secrets.properties. - Aggiungi al file una chiave API predefinita o segnaposto. Questo file può essere controllato nel controllo delle versioni:

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

Parte 3: aggiorna il file AndroidManifest.xml

1. Apri il file app/src/main/AndroidManifest.xml.

2. All'interno del tag <application>, prima del tag <activity>, aggiungi il seguente elemento <meta-data> per dichiarare la chiave API:

   <application
     ...>
   
     <meta-data
         android:name="com.google.android.geo.maps3d.API_KEY"
         android:value="${MAPS3D_API_KEY}" />
   
     <activity
         ...>
     </activity>
   </application>
   

   Durante il processo di compilazione, il plug-in Secrets Gradle sostituirà il segnaposto ${MAPS3D_API_KEY} con la chiave del file secrets.properties.

Passaggi successivi

Ora che hai un progetto Google Cloud, una chiave API e un progetto Android Studio configurati per l'utilizzo con l'SDK Maps 3D per Android, puoi aggiungere una mappa 3D alla tua app.