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

Android Studio projesi oluşturma

Uygulamanızı Android için Yerler SDK'sını kullanacak şekilde yapılandırmak üzere aşağıdaki adımları izleyin. Android için Yerler SDK'sını kullanan tüm uygulamalarda gereklidirler.

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 kitaplığı için Yerler SDK'sı,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 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()
    }
} 
```

Ü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()
    }
}

Modül düzeyindeki build.gradle dosyanızın dependencies bölümünde, Android için Yerler SDK'sına bağımlılık ekleyin:
```
dependencies {
    implementation 'com.google.android.libraries.places:places:3.1.0'
}
```
Modül düzeyindeki build.gradle dosyanızda compileSdk ve minSdk değerlerini aşağıdaki değerlere ayarlayın:
Not: compileSdk alanının 31 veya daha yüksek, minSdk değerinin 21 veya daha yüksek bir değere ayarlandığından emin olun.
```
android {
    compileSdk 31

    defaultConfig {
        minSdk 21
        // ...
    }
```

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 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
}
```
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'
    
```
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ı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 Yerler SDK'sı da dahil olmak üzere Google Haritalar tabanlı birden fazla API'de kimlik doğrulaması yapmak 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: Yerler API'si istemcisini ilk kullanıma hazırlayın

Aşağıdaki örnekte gösterildiği gibi bir etkinlik veya parça içerisinde Android için Yerler SDK'sını başlatın (Places.initialize() çağırırken API anahtarını ilettiğinize dikkat edin):

Java


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

Kotlin


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

Artık Android için Yerler SDK'sını kullanmaya hazırsınız!

5. Adım: Bir Android cihaz kurun

Android için Yerler SDK'sını kullanan bir uygulamayı çalıştırmak için, 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.
Not: Android emülatörü kullanmayı seçerseniz Play Store sütununun altında görüntülenen Play simgesi olan bir cihaz seçtiğinizden emin olun. Bu simge, profillerin tamamen CTS ile uyumlu olduğunu ve Play Store uygulamasını içeren sistem görüntüleri kullanabileceğini belirtir:

Sonraki adımlar

Projeniz yapılandırıldıktan sonra örnek uygulamaları inceleyebilirsiniz.