Per configurare l'app per l'utilizzo di Places SDK per Android, segui questi passaggi. Sono obbligatori per tutte le app che utilizzano Places SDK per Android.
Passaggio 1: configura Android Studio
Questo documento descrive un ambiente di sviluppo che utilizza Android Studio Hedgehog e il plug-in Android Gradle versione 8.2.
Passaggio 2. Configurare l'SDK
La libreria Places SDK per Android è disponibile tramite il Repository Maven di Google. Per aggiungere l'SDK alla tua app, procedi nel seguente modo:
- Nel file
settings.gradle
di primo livello, includi il portale del plug-in Gradle, il Repository Maven di Google e il repository centrale Maven nel bloccopluginManagement
. Il bloccopluginManagement
deve apparire prima di qualsiasi altra istruzione nello script.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Nel file
settings.gradle
di primo livello, includi il Repository Maven di Google e il repository centrale Maven nel bloccodependencyResolutionManagement
:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
-
Nella sezione
dependencies
del filebuild.gradle
a livello di modulo, aggiungi una dipendenza a Places SDK per Android:Trendy
dependencies { // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version")) implementation 'com.google.android.libraries.places:places:3.3.0' }
Kotlin
dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version")) implementation("com.google.android.libraries.places:places:3.5.0") }
- Nel file
build.gradle
a livello di modulo, impostacompileSdk
eminSdk
sui seguenti valori:Trendy
android { compileSdk 34 defaultConfig { minSdk 21 // ... } }
Kotlin
android { compileSdk = 34 defaultConfig { minSdk = 21 // ... } }
- Nella sezione
buildFeatures
del filebuild.gradle
a livello di modulo, aggiungi la classeBuildConfig
che utilizzerai per accedere ai valori dei metadati definiti più avanti in questa procedura:Trendy
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 l'app possa farvi riferimento in modo sicuro. Non dovresti verificare la chiave API nel tuo sistema di controllo della versione, quindi ti consigliamo di memorizzarla nel file secrets.properties
, che si trova nella directory radice del tuo 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 nel tuo progetto Google Maps:
-
In Android Studio, apri il file
build.gradle
obuild.gradle.kts
di primo livello e aggiungi il seguente codice all'elementodependencies
inbuildscript
.Trendy
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") } }
-
Apri il file
build.gradle
a livello di modulo e aggiungi il seguente codice all'elementoplugins
.Trendy
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- Nel file
build.gradle
a livello di modulo, assicurati chetargetSdk
ecompileSdk
siano impostati su 34. - Salva il file e sincronizza il progetto con Gradle.
-
Apri il file
secrets.properties
nella directory di primo livello, quindi aggiungi il codice seguente. SostituisciYOUR_API_KEY
con la tua chiave API. Archivia la chiave in questo file perchésecrets.properties
è escluso dall'archiviazione in un sistema di controllo della versione.PLACES_API_KEY=YOUR_API_KEY
- Salva il file.
-
Crea il file
local.defaults.properties
nella directory di primo livello, la stessa cartella del filesecrets.properties
, quindi aggiungi il codice seguente.PLACES_API_KEY=DEFAULT_API_KEY
Lo scopo di questo file è fornire un percorso di backup per la chiave API se non viene trovato il file
secrets.properties
, in modo da evitare errori di build. Questo può accadere se cloni l'app da un sistema di controllo della versione che omettesecrets.properties
e non hai ancora creato in locale un filesecrets.properties
per fornire la tua chiave API. - Salva il file.
-
In Android Studio, apri il file
build.gradle
obuild.gradle.kts
a livello di modulo e modifica la proprietàsecrets
. Se la proprietàsecrets
non esiste, aggiungila.Modifica le proprietà del plug-in impostando
propertiesFileName
susecrets.properties
, impostadefaultPropertiesFileName
sulocal.defaults.properties
e imposta eventuali altre proprietà.Trendy
secrets { // Optionally specify a different file name 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" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
Kotlin
secrets { // Optionally specify a different file name 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" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
Passaggio 4. Inizializzare il client API Places
Inizializza Places SDK per Android all'interno di un'attività o di un frammento. Devi prima decidere quale versione dell'SDK utilizzare: Places SDK for Android o Places SDK for Android (nuova). Per maggiori informazioni sulle versioni del prodotto, consulta Scegliere la versione dell'SDK.
L'esempio seguente mostra come inizializzare l'SDK per entrambe le versioni.SDK Places per Android (novità)
Passa la chiave API durante la chiamata a
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);
Places SDK for Android
Passa la chiave API durante la chiamata a
Places.initialize()
:
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.initialize(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.initialize(getApplicationContext(), apiKey); // Create a new PlacesClient instance PlacesClient placesClient = Places.createClient(this);
Ora puoi iniziare a utilizzare Places SDK per Android.
Passaggio 5: configura un dispositivo Android
Per eseguire un'app che utilizza Places SDK per Android, devi eseguirne il deployment su un dispositivo Android o in un emulatore Android basato su Android 5.0 o versioni successive 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 installarlo utilizzando lo strumento Gestione dispositivi virtuali (AVD) Android (Android Virtual Device, Gestione AVD) fornito in Android Studio.