Configurazione

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

Configurare un progetto Google Cloud e una chiave API

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

gcloud projects create "PROJECT"

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"

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

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

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

Configurare un progetto Android Studio

Questa sezione spiega come creare e configurare un progetto Android Studio da utilizzare con Maps SDK 3D per Android.

Parte 1: configurare il progetto e la configurazione di Gradle

1. Crea un nuovo progetto Android Studio utilizzando il modello Attività con visualizzazioni vuote.

2. Se utilizzi Git per il controllo del codice sorgente, modifica il file .gitignore del progetto per impedire che il file dei secret venga eseguito il commit nel controllo della versione:

   • Nella directory root 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 root 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 root del progetto.
   • Nella sezione [versions], aggiungi le versioni dell'SDK e del plug-in Secrets Gradle:

   # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
   maps3dSdk = "0.2.0"
   # See https://github.com/google/secrets-gradle-plugin/releases for available releases
   secretsGradlePlugin = "2.0.1"
   

   • Nella sezione [library], aggiungi la libreria SDK:

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

   • Nella sezione [plugins], aggiungi il plug-in Secrets Gradle:

   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
   }
   

   • Nel blocco dependencies, aggiungi l'SDK:

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

   • Alla fine del file, al di fuori dei blocchi android e dependencies, aggiungi la configurazione dei secret:

   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: aggiungere la chiave API al progetto

1. Crea un file secrets.properties:

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

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   

2. Crea un file local.defaults.properties: - Nella directory root del modulo dell'app, crea un nuovo file denominato secrets.properties. - Aggiungi una chiave API predefinita o segnaposto al file. Questo file può essere eseguito il commit nel controllo della versione:

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

Parte 3: aggiornare 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 configurato un progetto Google Cloud, una chiave API e un progetto Android Studio da utilizzare con Maps SDK 3D per Android, puoi aggiungere una mappa 3D alla tua app.