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ı kullanacak şekilde nasıl yapılandıracağınız açıklanmaktadır.
Google Haritalar şablonu otomatik olarak yapılandırılarak yeni bir Android Studio projesine temel harita ekler. Bununla birlikte, farklı bir Android Studio şablonu kullanan Android projelerine de harita ekleyebilirsiniz. Bunu yapmak için projenizi manuel olarak yapılandırmanız ve harita eklemeniz gerekir.
1. Adım: Android Studio'yu kurun
- Android Studio Arctic Fox veya üzeri gereklidir. Henüz yapmadıysanız indirin ve yükleyin.
- Android Studio'da Android Gradle eklentisinin 7.0 veya sonraki bir sürümünü kullandığınızdan emin olun.
2. adım: SDK'yı ayarlayın
Android için Haritalar SDK'sı kitaplığı, Google'ın Maven deposu üzerinden kullanılabilir. 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ına Maven merkezi deposunu ekleyin.pluginManagement
bloğu, komut dosyasındaki diğer tüm ifadelerden önce görünmelidir.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- En üst düzey
settings.gradle
dosyanıza Google Maven deposu ile 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ıza 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ızdacompileSdk
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ızın uygulamanız tarafından güvenli bir şekilde referans alınabilmesi için nasıl depolanacağı açıklanmaktadır. API anahtarınızı sürüm kontrol sisteminize kontrol etmemeniz gerekir. Bu nedenle, anahtarı projenizin kök dizininde bulunan local.properties
dosyasında depolamanızı öneririz. local.properties
dosyası hakkında daha fazla bilgi için Gradle mülklerindeki 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 ve aşağıdaki kodubuildscript
altındakidependencies
öğesine 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çın, ardından 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
konumuna 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 önerilen meta veri adı com.google.android.geo.API_KEY
. Bu ada sahip bir anahtar, Android platformundaki Haritalar SDK'sı da dahil olmak üzere Android platformunda birden fazla Google Haritalar tabanlı API'de kimlik doğrulaması yapmak için kullanılabilir. API, geriye dönük uyumluluk için 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 belirtilirse 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 Hizmetleri 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 cihaz konumu sağlayan ACCESS_FINE_LOCATION
ve daha az hassas olan ACCESS_COARSE_LOCATION
'dur. Ayrıntılar için konum verileri kılavuzuna bakın.
ACCESS_FINE_LOCATION
iznini 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 eski bir sürüm kullanıyorsanız ve uygulamanız API düzeyi 28'i (Android 9.0) veya sonraki bir sürümü hedefliyorsa AndroidManifest.xml
öğesinin <application>
öğesine aşağıdaki ifadeyi 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 uygulamayı Android 4.0 veya sonraki bir sürümü kullanan ve Google API'lerini içeren bir Android emülatörüne dağıtmanız gerekir.
- Android cihaz kullanmak için Donanım cihazında uygulama çalıştırma başlıklı makaledeki talimatları uygulayın.
- Android emülatörü kullanmak için bir sanal cihaz oluşturabilir ve Android Studio ile birlikte sunulan Android Sanal Cihaz (AVD) Yöneticisi'ni kullanarak emülatörü yükleyebilirsiniz.
Sonraki adımlar
Projeniz yapılandırıldıktan sonra bir harita ekleyebilirsiniz.