Android Studio projesi oluşturma

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

  1. Android Studio Arctic Fox veya üzeri gereklidir. Henüz yapmadıysanız indirin ve yükleyin.
  2. 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:

  1. Üst düzey settings.gradle dosyanıza Gradle eklenti portalını, Google Maven deposunu ve pluginManagement 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()
        }
    } 
  2. En üst düzey settings.gradle dosyanıza Google Maven deposu ile Maven merkezi deposunu dependencyResolutionManagement bloğunun altına ekleyin:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. 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'
        // ...
    } 
  4. Modül düzeyindeki build.gradle dosyanızda compileSdk ve minSdk 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:

  1. Android Studio'da proje düzeyindeki build.gradle dosyanızı açın ve aşağıdaki kodu buildscript altındaki dependencies öğesine ekleyin.
    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
    }
  2. Ardından, modül düzeyindeki build.gradle dosyanızı açın ve aşağıdaki kodu plugins öğesine ekleyin.
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
        
  3. Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
  4. 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
        
  5. Dosyayı kaydedin.
  6. AndroidManifest.xml dosyanızda com.google.android.geo.API_KEY konumuna gidip android: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.