Kurulum

Bu sayfada, Android için Haritalar 3D SDK'sı ile geliştirmeye başlamak üzere yapmanız gerekenler açıklanmaktadır. Kurulum süreci, SDK ile kullanılacak bir Google Cloud projesi ve API'si yapılandırmayı ve ardından bir Android Studio projesi oluşturmayı içerir. Uygulamanıza ilk 3D haritanızı eklemeden önce bu adımları tamamlayın.

Ön koşullar

Android için Haritalar 3D SDK'sını kullanmak istiyorsanız projenizin ve hedef cihazlarınızın aşağıdaki şartları karşılaması gerekir:

• Minimum API düzeyi: Android API düzeyi 24 (Android 7.0) veya daha yüksek. Uygulamanız 24 veya daha yüksek bir minSdk hedeflemelidir.
• Google Play Hizmetleri: Android için Haritalar 3D SDK'sı, Google Play Hizmetleri'ne bağlıdır. Hedef cihazlarda (ve Google API'leri içeren emülatörlerde) Google Play Hizmetleri yüklü olmalıdır.

Google Cloud projesi ve API anahtarı oluşturma

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

1. Adım

Konsol

1. 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 gidin

2. 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, ücretsiz deneme sürümü sunar. Deneme süresi, 90 günün sonunda veya hesapta 300 ABD doları tutarında ücret tahakkuk ettikten sonra (hangisi önce gerçekleşirse) sona erer. İstediğ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üklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

• gcloud projects create

Not: Bir öğrenme alıştırmasında oluşturduğunuz kaynakları saklamayı planlamıyorsanız mevcut bir projeyi seçmek yerine yeni bir proje oluşturun. Alıştırmayı tamamladıktan sonra projeyi silebilir ve projeyle ilişkili tüm kaynakları kaldırabilirsiniz.

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 etkinleştirmeniz gerektiğini unutmayın. Hangi API'leri veya SDK'ları etkinleştirmeniz gerektiğinden emin değilseniz Özellikler Gezgini'ni kullanmayı deneyin veya kullanmak istediğiniz API/SDK ile ilgili belgelere bakın.

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

Konsol

1. Cloud Console'da Haritalar API Kitaplığı sayfasına giderek etkinleştirebileceğiniz Google Haritalar Platformu API'lerini ve SDK'larını görebilirsiniz:

   Maps API Kitaplığı sayfasına gidin.

2. Etkinleştirmek istediğiniz API'yi 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 etkindir 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 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 tüm Maps, Routes ve Places API'lerini 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üklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

• gcloud services enable
• gcloud services disable

Environment API'leri 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"

Not: Places API'yi etkinleştirdiğinizde Yer Kitaplığı, Maps JavaScript API, Android için Yerler SDK'sı ve iOS için Yerler SDK'sı da etkinleştirilir.

3. Adım

Bu adımda yalnızca API anahtarı oluşturma işlemi açıklanmaktadır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Ürüne özel API Anahtarlarını Kullanma sayfasında daha fazla bilgi 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şkili en az bir API anahtarınız olmalıdır.

API anahtarı oluşturmak için:

Konsol

1. Google Haritalar Platformu > Kimlik bilgileri sayfasına gidin.

   Kimlik Bilgileri sayfasına gidin.

2. 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.
3. 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üklemesi 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ına bakın. 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ılacak bir 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

1. Empty Views Activity şablonunu kullanarak yeni bir Android Studio projesi oluşturun. Proje yapılandırmasında Minimum SDK'yı API 24 veya daha yüksek bir sürüme ayarlayın.

2. Kaynak denetimi için Git kullanıyorsanız gizli anahtar dosyanızın sürüm denetimine kaydedilmesini önlemek için proje .gitignore dosyasını değiştirin:

   • Projenizin kök dizininde .gitignore dosyasını açın.
   • Aşağıdaki satırı ekleyin:

   secrets.properties
   

3. 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
   }
   

4. gradle/libs.versions.toml dosyasını güncelleyin:

   • Genellikle proje kök dizinindeki gradle dizininde bulunan gradle/libs.versions.toml dosyasını açın.
   • [versions] bölümünde SDK ve Secrets Gradle eklentisinin sürümlerini ekleyin:

   # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
   maps3dSdk = "16.0.1"
   # See https://github.com/google/secrets-gradle-plugin/releases for available releases
   secretsGradlePlugin = "2.0.1"
   

   • [library] bölümünde SDK kitaplığını ekleyin:

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

   • [plugins] bölümüne Secrets Gradle eklentisini ekleyin:

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

5. 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 üst kısmında, Secrets Gradle eklentisini plugins bloğuna ekleyin:

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

   • dependencies bloğunda, Android için Haritalar 3D SDK'sının Google Play Hizmetleri bağımlılığını ekleyin:

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

   • Dosyanın sonuna, android ve dependencies bloklarının dışına gizli anahtar yapılandırmasını ekleyin:

   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

1. secrets.properties dosyası oluşturun:

   • 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
   

   Not: YOUR_API_KEY_HERE ifadesini, Android için Haritalar 3D SDK'sı ile kullanılmak üzere yapılandırdığınız API anahtarıyla değiştirdiğinizden emin olun.

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

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

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

1. app/src/main/AndroidManifest.xml dosyasını açın.

2. <application> etiketinin 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 Plugin, ${MAPS3D_API_KEY} yer tutucusunu secrets.properties dosyanızdaki anahtarla değiştirir.

Programatik görünüm başlatma (isteğe bağlı)

Harita görünümünüzü XML düzenleri yerine programatik olarak başlatmayı tercih ediyorsanız Map3DInitConfig kullanın.

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

Sonraki adımlar

Android için Haritalar 3D SDK'sı ile kullanılmak üzere ayarlanmış bir Google Cloud projeniz, API anahtarınız ve Android Studio projeniz olduğuna göre artık uygulamanıza 3D harita ekleyebilirsiniz.