Yeni harita stilleri yakında Google Haritalar Platformu'nda kullanıma sunulacak. Harita stilinde yapılan bu güncelleme, yeni bir varsayılan renk paletinin yanı sıra harita deneyimleri ve kullanılabilirliğiyle ilgili iyileştirmeler içermektedir. Tüm harita stilleri Mart 2025'te otomatik olarak güncellenecektir. Bu özelliğin kullanılabilirliği ve bu özelliğe daha önce nasıl katılacağınız hakkında daha fazla bilgi edinmek için Google Haritalar Platformu için yeni harita stili başlıklı makaleyi inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Android Studio projesi oluşturma

Bu sayfada, Google Haritalar şablonunu kullanmadan Android için Haritalar SDK'sı Hızlı başlangıç kılavuzunda bulabilirsiniz.

Google Haritalar şablonu, yeni bir harita oluşturmaya otomatik olarak temel bir harita ekler Android Studio projesi. Ancak Android projelerine harita da ekleyebilirsiniz Studio şablonu kullanır. Bunu yapmak için manuel olarak projenizi yapılandırın ve ardından haritayı ekleyin.

1. Adım: Android Studio'yu kurun

Bu dokümanda, Android Studio Hedgehog ve Android Gradle eklentisi sürümü 8.2'dir.

2. adım: SDK'yı ayarlama

Android için Haritalar SDK'sı kitaplığını şurada bulabilirsiniz: Google'ın Maven deposu. Alıcı: SDK'yı uygulamanıza ekledikten sonra aşağıdakileri yapın:

Üst düzey settings.gradle.kts dosyanıza Gradle eklenti portalı, Google Maven deposu, ve Maven merkez deposu pluginManagement blokunun altında. pluginManagement bloğu komut dosyasındaki diğer tüm ifadelerden önce görünmelidir.
```
pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
} 
```

Üst düzey settings.gradle.kts dosyanıza Google'ın Maven deposu ve Maven merkez deposu dependencyResolutionManagement bloğunun altında:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

Modül düzeyindeki build.gradle.kts veya build.gradle dosyanıza Google Play Hizmetleri Google Haritalar SDK'sı.

Kotlin

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

Modern

dependencies {

    // Maps SDK for Android
    implementation "com.google.android.gms:play-services-maps:19.0.0"
}

Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızda, compileSdk ve minSdk değerlerini şu değerlere ayarla:
Not: compileSdk değerinin 34 veya daha yüksek bir değere ve minSdk değerine ayarlayın 21 veya daha yüksek bir değere ayarlandığında yapılır.
Kotlin
```
android {
    compileSdk = 34

    defaultConfig {
        minSdk = 21
        // ...
    }
}
```
Modern
```
android {
    compileSdk 34

    defaultConfig {
        minSdk 21
        // ...
    }
}
```
Modül düzeyindeki build.gradle.kts sayfanızın buildFeatures bölümünde veya build.gradle dosyası varsa, kullanabileceğiniz BuildConfig sınıfını ekleyin. bu prosedürün ilerleyen bölümlerinde tanımlanan meta veri değerlerine erişim izni gerekir:
Kotlin
```
android {
  // ...
  buildFeatures {
    buildConfig = true
    // ...
  }
}
```
Modern
```
android {
  // ...
  buildFeatures {
    buildConfig true
    // ...
  }
}
```

3. Adım: API anahtarınızı projeye ekleyin

Bu bölümde, web siteleri tarafından güvenli bir şekilde referans verilebilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır. en iyi şekilde yararlanabilirsiniz. API anahtarınızı sürüm kontrol sisteminize kontrol etmemeniz gerekir, bu nedenle dosyayı, uygulamanızın kök dizininde bulunan secrets.properties dosyasında depolayarak belirler. secrets.properties dosyası hakkında daha fazla bilgi için bkz. Gradle özellikleri dosyaları.

Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin.

Google Haritalar projenize Android için Secrets Gradle Eklentisi'ni yüklemek için:

Android Studio'da üst düzey build.gradle.kts veya build.gradle dosyasını seçin ve aşağıdaki kodu altındaki dependencies öğesine ekleyin buildscript.

Kotlin

buildscript {
    dependencies {
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
    }
}

Modern

buildscript {
    dependencies {
        classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
    }
}

Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızı açın ve plugins öğesine aşağıdaki kodu ekleyin.

Kotlin

plugins {
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}

Modern

plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızda targetSdk ve compileSdk ayarlandığı için 34 yaşına bastı.
Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
secrets.properties dosyasını en üst düzey dizininizde açın ve şunu ekleyin: aşağıdaki kodu kullanabilirsiniz. YOUR_API_KEY kısmını API anahtarınızla değiştirin. Anahtarınızı bu dosyada depolayın secrets.properties, sürüm kontrolüne kontrol edilmekten hariç tutulduğundan bahsedeceğim.
Not: secrets.properties dosyası local.properties dosyasıyla aynı klasörde oluşturun.
```
MAPS_API_KEY=YOUR_API_KEY
```
Dosyayı kaydedin.
Üst düzey dizininizde local.defaults.properties dosyasını oluşturun. klasörünü secrets.properties dosyası olarak kaydedin, ardından aşağıdaki kodu ekleyin.

Not: Kodu gösterildiği gibi girin. Değiştirme API anahtarınızla DEFAULT_API_KEY.
```
MAPS_API_KEY=DEFAULT_API_KEY
```
Bu dosyanın amacı, Derlemelerin başarısız olmaması için secrets.properties dosyası bulunamadı. Bu durum, uygulamayı, secrets.properties ve sağlamak için henüz yerel olarak bir secrets.properties dosyası oluşturmadınız API anahtarı.
Dosyayı kaydedin.
AndroidManifest.xml dosyanızda şuna gidin: com.google.android.geo.API_KEY ve android:value attribute öğesini güncelleyin. <meta-data> etiketi mevcut değilse bunu <application> etiketi.
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />
```
Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other properties.

Kotlin

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"

    // Configure which keys should be ignored by the plugin by providing regular expressions.
    // "sdk.dir" is ignored by default.
    ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
    ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
}

Modern

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"

    // Configure which keys should be ignored by the plugin by providing regular expressions.
    // "sdk.dir" is ignored by default.
    ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
    ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
}

4. Adım: Uygulama manifestini güncelleyin

Bu bölümde, hesabınıza eklenecek ayarlar AndroidManifest.xml dosyası olarak kaydedin.

Google Play hizmetleri sürüm numarası

application öğesine aşağıdaki beyanı ekleyin. Bu yerleştirilmiş öğeler uygulamanın derlendiği Google Play Hizmetleri sürümü.

<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 konum iznini AndroidManifest.xml dosyanızda bulabilirsiniz. Seçenekler Tam cihaz konumunu gösteren ACCESS_FINE_LOCATION ve ACCESS_COARSE_LOCATION, daha az kesindir. Ayrıntılar için konum verileri rehberini inceleyin.

ACCESS_FINE_LOCATION iznini istemek için bu kodu manifest öğesi:

<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 yok. Hedeflenen Google Play Hizmetleri SDK'sının önceki sürümlerinden birini kullanıyorsanız WRITE_EXTERNAL_STORAGE manifest öğesinde izni var.

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Eski Apache HTTP 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 (Android 9.0) veya sonraki sürümleri hedefliyorsa <application> öğesi içinde yer alan aşağıdaki beyanı AndroidManifest.xml. Aksi takdirde bu beyanı atlayın.

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

5. Adım: Android cihaz kurun

Android için Haritalar SDK'sını kullanan bir uygulamayı çalıştırmak istiyorsanız bunu bir Android cihaza veya Android'e dağıtmanız gerekir. Android 5.0 veya sonraki sürümleri temel alan ve Google API'leri.

Android cihaz kullanmak için şu adresteki talimatları uygulayın: Uygulamaları donanım cihazında çalıştırma.
Android emülatörü kullanmak için sanal cihaz oluşturabilir ve Android Sanal Cihaz (AVD) Yöneticisi bir uygulamadır.
Not: Android emülatörü kullanmayı seçerseniz Play Store sütununun altında görüntülenen Oynat simgesi olan bir cihaz seçin. Bu simge, bu profillerin tamamen CTS olduğunu gösterir uyumlu olmalıdır ve Play Store uygulamasını içeren sistem resimlerini kullanabilir:

6. Adım: İsteğe bağlı olarak Play Hizmeti desteği olup olmadığını kontrol edin

Android için Haritalar SDK'sı, uygulamanızı dağıttığınız cihazın uygulamasında Google Play Hizmetleri yüklü olmalıdır. Google, bu bilgileri kontrol etmek için uygulamanızdan arayabilir. Daha fazla bilgi için Google'ın Play Hizmetleri yüklü olmalıdır.

Sonraki adımlar

Projeniz yapılandırıldıktan sonra harita ekleyebilirsiniz.