Configurazione

Questa pagina descrive cosa devi fare per configurare l'ambiente di sviluppo con l'SDK Maps 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 3D SDK per Android, devi configurare un progetto Google Cloud e una chiave API da utilizzare con Maps 3D SDK 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 di selezione del progetto

  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. Annulla in qualsiasi momento. Per ulteriori informazioni, vedi Crediti dell'account di fatturazione e Fatturazione.

Cloud SDK

gcloud projects create "PROJECT"

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

Passaggio 2

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 il selettore di API o consulta la documentazione dell'API/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 della libreria di API Maps nella console Cloud:

    Vai alla pagina della libreria API di Maps

  2. Fai clic sull'API o sull'SDK che vuoi abilitare.
    • Se il pulsante indica ABILITA, fai clic sul pulsante 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 due 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 comando seguente 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 , 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

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 ulteriori informazioni nella pagina Utilizzo di chiavi API specifica del prodotto.

La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto a 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.
    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 nella sezione 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 , installazione di Cloud SDK e sui seguenti comandi:

Per abilitare l'SDK, consulta la pagina SDK Maps 3D per Android nella console Google Cloud. Per saperne di più 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 da utilizzare con Maps 3D SDK for Android.

Parte 1: configura 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 il commit del file dei segreti nel 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 dell'SDK e del plug-in Secrets Gradle:

    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 di solito 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 tuo progetto

  1. Crea un file secrets.properties:

    • Nella directory root 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 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 inserito 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 configurato un progetto Google Cloud, una chiave API e un progetto Android Studio da utilizzare con Maps 3D SDK for Android, puoi aggiungere una mappa 3D alla tua app.