Android Studio projesi oluşturma

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

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

  1. Üst düzey settings.gradle dosyanıza Gradle eklenti portalını, Google Maven deposunu ve pluginManagement 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()
        }
    } 
  2. Üst düzey settings.gradle dosyanıza Google'ın Maven deposu ve 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ı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'
        // ...
    } 
  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ı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:

  1. Android Studio'da proje düzeyindeki build.gradle dosyanızı açın ve buildscript altındaki dependencies öğesine aşağıdaki kodu 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çıp 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 adresine 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 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.