Uygulamanızı Android için Yerler SDK'sını kullanacak şekilde yapılandırmak için aşağıdaki adımları uygulayın: adımları. Bunlar, Android için Yerler SDK'sını kullanan tüm uygulamalarda gereklidir.
1. Adım: Android Studio'yu kurun
Bu dokümanda, Android Studio Hedgehog ve Android Gradle eklentisi sürümü 8.2'dir.
2. adım: SDK'yı ayarlama
Android için Yerler SDK'sını kullanarak Google'ın Maven deposu. Alıcı: SDK'yı uygulamanıza ekledikten sonra aşağıdakileri yapın:
- Üst düzey
settings.gradle
dosyanıza Gradle eklenti portalı, Google Maven deposu, ve Maven merkez deposupluginManagement
blokunun altında.pluginManagement
bloğu komut dosyasındaki diğer tüm ifadelerden önce görünmelidir.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Üst düzey
settings.gradle
dosyanıza Google'ın Maven deposu ve Maven merkez deposudependencyResolutionManagement
bloğunun altında:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
-
dependencies
içinde modül düzeyindekibuild.gradle
dosyanızın bölümüne bir bağımlılık ekleyin Android için Yerler SDK'sına:Modern
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") }
- Modül düzeyindeki
build.gradle
dosyanızdacompileSdk
veminSdk
için şu değerlere:Modern
android { compileSdk 34 defaultConfig { minSdk 21 // ... } }
Kotlin
android { compileSdk = 34 defaultConfig { minSdk = 21 // ... } }
- Modül düzeyindeki
build.gradle
dosyanızınbuildFeatures
bölümünde, daha sonra tanımlanan meta veri değerlerine erişmek için kullandığınızBuildConfig
sınıfını ekleyin. bu prosedürde:Modern
android { // ... buildFeatures { buildConfig true // ... } }
Kotlin
android { // ... buildFeatures { buildConfig = true // ... } }
3. Adım: API anahtarınızı projeye ekleyin
Bu bölümde, web siteleri tarafından güvenli bir şekilde referans verilebilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır.
en iyi şekilde yararlanabilirsiniz. API anahtarınızı sürüm kontrol sisteminize kontrol etmemeniz gerekir, bu nedenle
dosyayı, uygulamanızın kök dizininde bulunan secrets.properties
dosyasında depolayarak
belirler. secrets.properties
dosyası hakkında daha fazla bilgi için bkz.
Gradle özellikleri dosyaları.
Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin.
Google Haritalar projenize Android için Secrets Gradle Eklentisi'ni yüklemek için:
-
Android Studio'da üst düzey
build.gradle
veyabuild.gradle.kts
dosyasını seçin ve aşağıdaki kodu altındakidependencies
öğesine ekleyinbuildscript
.Modern
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") } }
-
Modül düzeyindeki
build.gradle
dosyanızı açın ve aşağıdaki koduplugins
öğesi.Modern
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- Modül düzeyindeki
build.gradle
dosyanızdatargetSdk
vecompileSdk
, 34 olarak ayarlandı. - Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
-
secrets.properties
dosyasını en üst düzey dizininizde açın ve şunu ekleyin: aşağıdaki kodu kullanabilirsiniz.YOUR_API_KEY
kısmını API anahtarınızla değiştirin. Anahtarınızı bu dosyada depolayınsecrets.properties
, sürüm kontrolüne kontrol edilmekten hariç tutulduğundan bahsedeceğim.PLACES_API_KEY=YOUR_API_KEY
- Dosyayı kaydedin.
-
Üst düzey dizininizde
local.defaults.properties
dosyasını oluşturun. klasörünüsecrets.properties
dosyası olarak kaydedin, ardından aşağıdaki kodu ekleyin.PLACES_API_KEY=DEFAULT_API_KEY
Bu dosyanın amacı, Derlemelerin başarısız olmaması için
secrets.properties
dosyası bulunamadı. Bu durum, uygulamayı,secrets.properties
ve sağlamak için henüz yerel olarak birsecrets.properties
dosyası oluşturmadınız API anahtarı. - Dosyayı kaydedin.
-
Android Studio'da modül düzeyindeki
build.gradle
veyabuild.gradle.kts
dosyasını açın vesecrets
özelliğini düzenleyin. Öğesecrets
mülkü mevcut değil, ekleyin.propertiesFileName
eklentisini şuna ayarlamak için eklentinin özelliklerini düzenleyin:secrets.properties
,defaultPropertiesFileName
değerini şu şekilde ayarla:local.defaults.properties
ve diğer özellikleri ayarlayın.Modern
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.*" }
4. Adım. Places API istemcisini başlatma
Bir etkinlik veya parça içinde Android için Yerler SDK'sını başlatın. Öncelikle SDK'nın hangi sürümünü kullanacağınıza karar verin: Android için Yerler SDK'sı veya Android için Yerler SDK'sı (Yeni). Ürün sürümleri hakkında daha fazla bilgi için SDK sürümünüzü seçme başlıklı makaleyi inceleyin.
Aşağıdaki örnekte her iki sürüm için de SDK'nın nasıl başlatılacağı gösterilmektedir.Android için Yerler SDK'sı (Yeni)
Çağrı yaparken API anahtarını iletin
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);
Android için Yerler SDK'sı
Çağrı yaparken API anahtarını iletin
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);.
Artık Android için Yerler SDK'sını kullanmaya hazırsınız!
5. Adım: Android cihaz kurun
Android için Yerler SDK'sını kullanan bir uygulamayı çalıştırmak istiyorsanız bunu bir Android cihaza veya Android'e dağıtmanız gerekir. Android 5.0 veya sonraki sürümleri temel alan ve Google API'leri.
- Android cihaz kullanmak için şu adresteki talimatları uygulayın: Uygulamaları donanım cihazında çalıştırma.
- Android emülatörü kullanmak için sanal cihaz oluşturabilir ve Android Sanal Cihaz (AVD) Yöneticisi bir uygulamadır.