Configurare un progetto Android Studio

Per configurare l'app in modo che utilizzi l'API Places SDK for Android, segui questi passaggi. Sono obbligatori per tutte le app che utilizzano l'API Places SDK for Android.

Passaggio 1: configura Android Studio

Questo documento descrive un ambiente di sviluppo che utilizza Android Studio Hedgehog e il plug-in Android per Gradle versione 8.2.

Passaggio 2: configura l'SDK

La libreria dell'API Places SDK for Android è disponibile tramite il repository Maven di Google. Per aggiungere l'SDK alla tua app:

  1. Nel file settings.gradle.kts di primo livello, includi il portale del plug-in Gradle, repository Maven di Google, e repository Maven Central nel blocco pluginManagement. Il blocco pluginManagement deve essere visualizzato prima di qualsiasi altra istruzione nello script. 
    pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
  2. Nel file settings.gradle.kts di primo livello, includi il repository Maven di Google e il repository Maven Central nel blocco dependencyResolutionManagement: 
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
    }
}

  3. Nella sezione dependencies del file build.gradle.kts a livello di modulo, aggiungi una dipendenza all'API Places SDK for Android:

    Groovy

    dependencies {
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation("com.google.android.libraries.places:places:3.5.0")
}

    Kotlin

              dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:5.1.1")
}
  4. Nel file build.gradle.kts a livello di modulo, imposta compileSdk e minSdk sui seguenti valori:

    Groovy

    android {
    compileSdk 34

    defaultConfig {
        minSdk 23
        // ...
    }
}

    Kotlin

    android {
    compileSdk = 34

    defaultConfig {
        minSdk = 23
        // ...
    }
}
  5. Nella sezione buildFeatures del file build.gradle a livello di modulo, aggiungi la classe BuildConfig, che utilizzi per accedere ai valori dei metadati definiti più avanti in questa procedura:

    Groovy

    android {
  // ...
  buildFeatures {
    buildConfig true
    // ...
  }
}

    Kotlin

    android {
  // ...
  buildFeatures {
    buildConfig = true
    // ...
  }
}

Passaggio 3: aggiungi la chiave API al progetto

Questa sezione descrive come archiviare la chiave API in modo che possa essere referenziata in modo sicuro dalla tua app. Non devi archiviare la chiave API nel sistema di controllo della versione, quindi ti consigliamo di archiviarla nel file secrets.properties, che si trova nella directory principale del progetto. Per ulteriori informazioni sul file secrets.properties, consulta File delle proprietà di Gradle.

Per semplificare questa attività, ti consigliamo di utilizzare il plug-in Secrets Gradle per Android.

Per installare il plug-in Secrets Gradle per Android e archiviare la chiave API:

  1. In Android Studio, apri il file build.gradle a livello di root e aggiungi il seguente codice all'elemento dependencies in buildscript.

    Groovy

    buildscript {
    dependencies {
        // ...
        classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
    }
}

    Kotlin

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
    }
}
  2. Apri il file build.gradle a livello di app e aggiungi il seguente codice all' plugins elemento.

    Groovy

    plugins {
    id 'com.android.application'
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

    Kotlin

    plugins {
    id("com.android.application")
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}
  3. Se utilizzi Android Studio, sincronizza il progetto con Gradle.
  4. Apri il file local.properties nella directory a livello di progetto e aggiungi il seguente codice. Sostituisci YOUR_API_KEY con la tua chiave API. 
    PLACES_API_KEY=YOUR_API_KEY

Passaggio 4: inizializza il client dell'API Places

Per inizializzare l'API Places SDK for Android in un'attività o in un fragment, passa la chiave API quando chiami Places.initializeWithNewPlacesApiEnabled():

Kotlin

    // Define a variable to hold the Places API key.
    val apiKey = BuildConfig.PLACES_API_KEY

    // Log an error if apiKey is not set.
    if (apiKey.isEmpty() || apiKey == "DEFAULT_API_KEY") {
        Log.e("Places test", "No api key")
        finish()
        return
    }

    // Initialize the SDK
    Places.initializeWithNewPlacesApiEnabled(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

Java

    // Define a variable to hold the Places API key.
    String apiKey = BuildConfig.PLACES_API_KEY;

    // Log an error if apiKey is not set.
    if (TextUtils.isEmpty(apiKey) || apiKey.equals("DEFAULT_API_KEY")) {
      Log.e("Places test", "No api key");
      finish();
      return;
    }

    // Initialize the SDK
    Places.initializeWithNewPlacesApiEnabled(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

Ora puoi iniziare a utilizzare l'API Places SDK for Android.

Passaggio 5: configura un dispositivo Android

Per eseguire un'app che utilizza l'SDK Places per Android, devi eseguirne il deployment su un dispositivo Android o un emulatore Android basato su Android 6.0 o versioni successive e che includa le API di Google.

  • Per utilizzare un dispositivo Android, segui le istruzioni riportate in Eseguire app su un dispositivo hardware.
  • Per utilizzare un emulatore Android, puoi creare un dispositivo virtuale e installare l'emulatore utilizzando Gestione AVD disponibile in Android Studio.

Passaggi successivi

Dopo aver configurato il progetto, puoi esplorare le app di esempio.