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

Kurulum

Bu sayfada, Android için Maps 3D SDK ile geliştirme yapmaya başlamak üzere kurulum için yapmanız gerekenler açıklanmaktadır. Kurulum sürecinde, Google Cloud projesi ve API'yi SDK ile kullanılacak şekilde yapılandırma, ardından Android Studio projesi oluşturma yer alır. Uygulamanıza ilk 3D haritanızı eklemeden önce aşağıdaki adımları tamamlayın.

Google Cloud projesi ve API anahtarı oluşturma

Android için Haritalar 3D SDK'sı ile geliştirmeye başlamadan önce aşağıdaki adımları tamamlayarak Android için Haritalar 3D SDK'sı ile kullanmak üzere bir Google Cloud projesi ve API anahtarı oluşturmanız gerekir:

1. Adım

Konsol

Google Cloud Console'daki proje seçici sayfasında, yeni bir Cloud projesi oluşturmaya başlamak için Proje Oluştur'u tıklayın.

Proje seçici sayfasına gitme
Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Projeniz için faturalandırmanın etkinleştirildiğini onaylayın.

Google Cloud, 0,00 ABD doları tutarında bir deneme sunar. Deneme süresi, 90 günün sonunda veya hesapta 300 ABD doları değerinde ücret biriktikten sonra (hangisi önce gerçekleşirse) sona erer. Dilediğiniz zaman iptal edebilirsiniz. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma başlıklı makaleleri inceleyin.

Google Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK , Cloud SDK yükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

gcloud projects create

2. Adım

Google Haritalar Platformu'nu kullanmak için projenizde kullanmayı planladığınız API'leri veya SDK'ları etkinleştirmeniz gerekir.

Bazı entegrasyonlar için birden fazla API/SDK'yı etkinleştirmeniz gerektiğini unutmayın. Hangi API'leri veya SDK'ları etkinleştireceğinizden emin değilseniz API Seçici'yi kullanmayı deneyin ya da kullanmak istediğiniz API/SDK'nın belgelerine bakın.

Bir veya daha fazla API ya da SDK'yı etkinleştirmek için:

Konsol

Cloud Console'daki Haritalar API Kitaplığı sayfasına giderek etkinleştirebileceğiniz Google Haritalar Platformu API'leri ve SDK'larını inceleyin:

Haritalar API Kitaplığı sayfasına gidin.
Etkinleştirmek istediğiniz API veya SDK'yı tıklayın.
- Düğmede ETKİNLEŞTİR yazıyorsa API'yi veya SDK'yı etkinleştirmek için düğmeyi tıklayın.
- Düğmede YÖNET yazıyorsa API veya SDK zaten etkinleştirilmiştir ve başka bir işlem yapmanız gerekmez.
- Düğmelerden birini tıkladığınızda API veya SDK'nın kontrol paneli gösterilir. (API'yi veya SDK'yı bu projeden kaldırmak için DEVRE DIŞI BIRAK düğmesini tıklayın.)

Google Cloud SDK

Aşağıdaki komut, Haritalar, Rotalar ve Yerler API'lerinin tümünü etkinleştirir:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Google Cloud SDK , Cloud SDK yükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

Ortam API'lerini etkinleştirmek için şu komutu kullanın:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

3. Adım

Bu adımda yalnızca API anahtarı oluşturma süreci ele alınır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı kesinlikle öneririz. Daha fazla bilgiyi ürüne özel API Anahtarlarını Kullanma sayfasında bulabilirsiniz.

API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. Projenizle ilişkilendirilmiş en az bir API anahtarınız olmalıdır.

API anahtarı oluşturmak için:

Konsol

Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.

Kimlik bilgileri sayfasına gitme
Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
API anahtarı oluşturuldu iletişim kutusunda yeni oluşturduğunuz API anahtarı gösterilir.
Kapat'ı tıklayın.
Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
(Üretimde kullanmadan önce API anahtarını kısıtlamayı unutmayın.)

Google Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK yükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

gcloud services api-keys create

SDK'yı etkinleştirmek için Google Cloud Console'daki Android için Haritalar 3D SDK'sı sayfasını inceleyin. Bu adımları tamamlama hakkında daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Android Studio projesi oluşturma

Bu bölümde, Android için Haritalar 3D SDK'sı ile kullanılmak üzere Android Studio projesinin nasıl oluşturulacağı ve yapılandırılacağı açıklanmaktadır.

1. bölüm: Projenizi ve Gradle yapılandırmanızı ayarlama

Empty Views Activity (Boş Görünüm Etkinliği) şablonunu kullanarak yeni bir Android Studio projesi oluşturun.
Kaynak kontrolü için Git kullanıyorsanız sır dosyanızın sürüm kontrolüne işlenmesini önlemek üzere proje .gitignore dosyasını değiştirin:
- Projenizin kök dizininde .gitignore dosyasını açın.
- Aşağıdaki satırı ekleyin:
```
secrets.properties
```

Proje düzeyindeki build.gradle.kts dosyasını güncelleyin:

Projenizin kök dizininde build.gradle.kts dosyasını açın.
plugins bloğuna Secrets Gradle eklentisini ekleyin:

plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

gradle/libs.versions.toml dosyasını güncelleyin: - Genellikle proje kök dizinindeki gradle dizininde bulunan gradle/libs.versions.toml dosyasını açın. - Sürümler bölümünde, SDK ve Secrets Gradle eklentisinin sürümlerini ekleyin:

maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"

-   In the library section, add the SDK library:

play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

-   In the plugin section, add the Secrets Gradle plugin:

secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

Modül düzeyindeki app/build.gradle.kts dosyasını güncelleyin: - Genellikle app dizininde bulunan modül düzeyindeki build.gradle.kts dosyasını açın. - Dosyanın en üstünde, plugins bloğuna Secrets Gradle eklentisini ekleyin:

plugins {
  alias(libs.plugins.android.application)
  alias(libs.plugins.kotlin.android)
  alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

-   In the `dependencies` block, add the SDK:

dependencies {
  // ... other dependencies
  implementation(libs.play.services.maps3d) // Add this line
}

-   At the end of the file, outside of the `android` and `dependencies`
    blocks, add the secrets configuration:

secrets {
  // Optionally specify a different filename containing your secrets.
  // The plugin defaults to "local.properties"
  propertiesFileName = "secrets.properties"

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

2. bölüm: API anahtarınızı projenize ekleme

secrets.properties dosyası oluşturma:

Uygulama modülü kök dizininde (genellikle app dizini) secrets.properties adlı yeni bir dosya oluşturun.
API anahtarınızı dosyaya ekleyin:

MAPS3D_API_KEY=YOUR_API_KEY_HERE
``` Note: Make sure you
    replace `YOUR_API_KEY_HERE` with the API key that you configured for use
with the Maps 3D SDK for Android.

local.defaults.properties dosyası oluşturun: - Uygulama modülü kök dizininde secrets.properties adlı yeni bir dosya oluşturun. - Dosyaya varsayılan veya yer tutucu bir API anahtarı ekleyin. Bu dosya, sürüm denetimine eklenebilir:
```
MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
```

3. bölüm: `AndroidManifest.xml` dosyanızı güncelleme

app/src/main/AndroidManifest.xml dosyasını açın.
<application> etiketi içinde, <activity> etiketinden önce, API anahtarınızı bildirmek için aşağıdaki <meta-data> öğesini ekleyin:
```
<application
  ...>

  <meta-data
      android:name="com.google.android.geo.maps3d.API_KEY"
      android:value="${MAPS3D_API_KEY}" />

  <activity
      ...>
  </activity>
</application>
```
Derleme işlemi sırasında Secrets Gradle eklentisi, ${MAPS3D_API_KEY} yer tutucusunu secrets.properties dosyanızdaki anahtarla değiştirir.

Sonraki adımlar

Android için Haritalar 3D SDK'sı ile kullanılmak üzere bir Google Cloud projesi, API anahtarı ve Android Studio projesi oluşturduğunuza göre artık Uygulamanıza 3D harita ekleyebilirsiniz.

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

Google Cloud projesi ve API anahtarı oluşturma

1. Adım

Konsol

Google Cloud SDK

2. Adım

Konsol

Google Cloud SDK

3. Adım

Konsol

Google Cloud SDK

Android Studio projesi oluşturma

1. bölüm: Projenizi ve Gradle yapılandırmanızı ayarlama

2. bölüm: API anahtarınızı projenize ekleme

3. bölüm: AndroidManifest.xml dosyanızı güncelleme

Sonraki adımlar

Kurulum

3. bölüm: `AndroidManifest.xml` dosyanızı güncelleme