Bu sayfada, Hızlı Başlangıç bölümünde ayrıntılı olarak açıklanan Google Haritalar şablonunu kullanmadan Android için Haritalar SDK'sını kullanmak üzere bir Android Studio projesinin nasıl yapılandırılacağı açıklanmaktadır.
Google Haritalar şablonu, yeni bir Android Studio projesine temel bir haritayı otomatik olarak yapılandırır ve ekler. Ancak farklı Android Studio şablonu kullanan bir Android projesine de harita ekleyebilirsiniz. Bunu yapmak için projenizi manuel olarak yapılandırmanız ve haritayı eklemeniz gerekir.
1. Adım: Android Studio'yu kurun
- Android Studio Arctic Fox veya sonraki sürümler gerekir. Henüz yapmadıysanız uygulamayı indirin ve yükleyin.
- Android Gradle eklentisini Android Studio'da 7.0 veya daha yeni bir sürüm kullandığınızdan emin olun.
2. adım: SDK'yı ayarlayın
Android için Haritalar SDK'sı kitaplığına Google'ın Maven deposu üzerinden erişebilirsiniz. SDK'yı uygulamanıza eklemek için aşağıdakileri yapın:
- Üst düzey
settings.gradle
dosyanızapluginManagement
blokunun altındaki Gradle eklenti portalı, Google Maven deposu ve Maven merkezi deposu'nu ekleyin.pluginManagement
bloku, komut dosyasındaki diğer ifadelerden önce görünmelidir.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Üst düzey
settings.gradle
dosyanıza,dependencyResolutionManagement
blokunun altına Google'ın Maven deposu ve Maven merkezi deposunu ekleyin:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
- Modül düzeyindeki
build.gradle
dosyanıza, Android için Haritalar SDK'sına yönelik Google Play Hizmetleri bağımlılığını ekleyin.dependencies { // Maps SDK for Android implementation 'com.google.android.gms:play-services-maps:18.2.0' }
- Modül düzeyindeki
build.gradle
dosyanızda,compileSdk
veminSdk
değerlerini aşağıdaki değerlere ayarlayın:android { compileSdk 31 defaultConfig { minSdk 19 // ... }
3. Adım: API anahtarınızı projeye ekleyin
Bu bölümde, uygulamanızın güvenli bir şekilde başvuruda bulunabilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır. API anahtarınızı sürüm kontrol sisteminize kontrol etmemelisiniz. Bu nedenle, projenizin kök dizininde bulunan secrets.properties
dosyasında saklamanızı öneririz. secrets.properties
dosyası hakkında daha fazla bilgi için Gradle özellik dosyaları bölümüne bakın.
Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin'i kullanmanızı öneririz.
Android için Secrets Gradle Eklentisi'ni Google Haritalar projenize yüklemek için:
-
Android Studio'da, proje düzeyindeki
build.gradle
dosyanızı açın ve aşağıdaki kodubuildscript
altındakidependencies
öğesine ekleyin.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") } }
-
Open your module-level
build.gradle
file and add the following code to theplugins
element.Groovy
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- Save the file and sync your project with Gradle.
-
Open the
secrets.properties
in your project level directory, and then add the following code. ReplaceYOUR_API_KEY
with your API key.MAPS_API_KEY=YOUR_API_KEY