Bu sayfada, Quickstart adresinde ayrıntılı olarak açıklanan Google Haritalar şablonunu kullanmadan Android için Haritalar SDK'sınıkullanmak üzere nasıl yapılandıracağınız açıklanmaktadır.
Google Haritalar şablonu temel bir haritayı otomatik olarak yapılandırır ve yeni bir Android Studio projesine ekler. Bununla birlikte, farklı bir Android Studio şablonu kullanan bir Android projesine harita da ekleyebilirsiniz. Bunu yapmak için projenizi manuel olarak yapılandırmanız ve ardından harita eklemeniz gerekir.
1. Adım: Android Studio'yu kurun
- Android Studio Arctic Fox veya üzeri gerekir. Henüz yapmadıysanız indirin ve yükleyin.
- Android Studio'da Android Gradle eklentisini 7.0 veya daha yeni bir sürümü kullandığınızdan emin olun.
2. Adım: SDK'yı ayarlama
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ıza Gradle eklenti portalını, Google Maven deposunu vepluginManagement
bloğunun altındaki Maven merkezi deposunu dahil edin.pluginManagement
bloğu, komut dosyasındaki diğer ifadelerden önce görünmelidir.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Üst düzey
settings.gradle
dosyanıza Google'ın Maven deposu ve Maven merkezi deposunudependencyResolutionManagement
bloğunun altına ekleyin:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
- Modül düzeyindeki
build.gradle
dosyanızda, Android için Haritalar SDK'sının Google Play Hizmetleri bağımlılığını ekleyin.dependencies { implementation 'com.google.android.gms:play-services-maps:18.1.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, API anahtarınıza uygulamanızın güvenli bir şekilde başvuruda bulunabilmesi için nasıl depolanacağı açıklanmaktadır. API anahtarınızı sürüm kontrol sisteminizde kontrol etmemelisiniz. Bu yüzden, anahtarınızı projenizin kök dizininde bulunan local.properties
dosyasında depolamanızı öneririz. local.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 Secrets Gradle Plugin for Android'i kullanmanızı öneririz. Eklentiyi yüklemek ve API anahtarınızı depolamak için:
- Android Studio'da proje düzeyindeki
build.gradle
dosyanızı açın vebuildscript
altındakidependencies
öğesine aşağıdaki kodu ekleyin.plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false }
- Ardından, modül düzeyindeki
build.gradle
dosyanızı açın ve aşağıdaki koduplugins
öğesine ekleyin.id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
- Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
- Proje düzeyindeki dizininizde
local.properties
öğesini açıp aşağıdaki kodu ekleyin.YOUR_API_KEY
yerine API anahtarınızı yazın.MAPS_API_KEY=YOUR_API_KEY
- Dosyayı kaydedin.
AndroidManifest.xml
dosyanızdacom.google.android.geo.API_KEY
adresine gidipandroid:value attribute
dosyasını aşağıdaki gibi güncelleyin:<meta-data android:name="com.google.android.geo.API_KEY" android:value="${MAPS_API_KEY}" />
Not: Yukarıda gösterildiği gibi, API anahtarı için com.google.android.geo.API_KEY
önerilen meta veri adıdır. Bu ada sahip bir anahtar, Android platformunda Google Haritalar SDK'sı da dahil olmak üzere Android platformunda birden fazla Google Haritalar tabanlı API'nin kimliğini doğrulamak için kullanılabilir. Geriye dönük uyumluluk için API aynı zamanda com.google.android.maps.v2.API_KEY
adını da destekler. Bu eski ad, yalnızca Android Maps API v2'de kimlik doğrulamaya olanak tanır. Bir uygulama, API anahtarı meta veri adlarından yalnızca birini belirtebilir. Her ikisi de belirtilmişse API bir istisna atar.
4. Adım: Uygulama manifestini güncelleyin
Bu bölümde AndroidManifest.xml
dosyanıza eklenecek ayarlar açıklanmaktadır.
Google Play hizmetleri sürüm numarası
application
öğesine aşağıdaki ifadeyi ekleyin. Bu, uygulamanın derlendiği Google Play hizmetlerinin sürümünü yerleştirir.
<meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
Konum izni
Uygulamanızın, kullanıcının konumuna erişmesi gerekiyorsa AndroidManifest.xml
dosyanızda konum izni istemeniz gerekir. Seçenekler, tam kullanıcı konumunu sağlayan ACCESS_FINE_LOCATION
ve daha az hassas olan ACCESS_COARSE_LOCATION
seçenekleridir. Ayrıntılı bilgi için konum verileri kılavuzuna bakın.
ACCESS_FINE_LOCATION
izni istemek için bu kodu manifest
öğesine ekleyin:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
Harici depolama izni
Google Play Hizmetleri SDK'sının 8.3 veya sonraki bir sürümünü hedefliyorsanız WRITE_EXTERNAL_STORAGE
iznine ihtiyacınız yoktur. Google Play Hizmetleri SDK'sının önceki sürümlerini hedefliyorsanız manifest
öğesinde WRITE_EXTERNAL_STORAGE iznini istemeniz gerekir.
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Apache HTTP Eski kitaplığı
com.google.android.gms:play-services-maps:16.0.0
veya daha düşük bir sürüm kullanıyorsanız ve uygulamanız API düzeyi 28'i (Android 9.0) veya sonraki sürümleri hedefliyorsa AndroidManifest.xml
öğesinin <application>
öğesine aşağıdaki beyanı eklemeniz gerekir. Aksi takdirde bu beyanı atlayın.
<uses-library
android:name="org.apache.http.legacy"
android:required="false" />
5. Adım: Bir Android cihaz kurun
Android için Haritalar SDK'sını kullanan bir uygulamayı çalıştırmak için bu uygulamayı Android 4.0 veya sonraki bir sürümü temel alan ve Google API'lerini içeren bir Android cihaza veya Android emülatörüne dağıtmanız gerekir.
- Android cihaz kullanmak için Donanım cihazlarında uygulama çalıştırma bölümündeki talimatları uygulayın.
- Android emülatörü kullanmak için sanal bir cihaz oluşturabilir ve Android Studio ile birlikte sunulan Android Sanal Cihaz (AVD) Yöneticisini kullanarak emülatörü yükleyebilirsiniz.
Sonraki adımlar
Projeniz yapılandırıldıktan sonra bir harita ekleyebilirsiniz.