Android Yardımcı Programı Kurulumu için Haritalar SDK'sı

Platform seçin: Android iOS

Bu sayfada, Android için Haritalar SDK'sı yardımcı program kitaplığının nasıl ayarlanacağı ve kitaplıkta yer alan demo uygulamasının nasıl çalıştırılacağı açıklanmaktadır.

Ön koşullar ve notlar

Android için Haritalar SDK'sı yardımcı program kitaplığı, Android API düzeyini 15 ve üzeri sürümlerde destekler. Proje derleme hedefinizi ayarlarken en son Android API düzeyini kullandığınızdan emin olun.

Referans belgelerine GitHub'dan ulaşabilirsiniz.

1. Adım: Android için Haritalar SDK'sı yardımcı program kitaplığını yükleme

Uygulamanızın build.gradle.kts dosyasına aşağıdaki bağımlılığı ekleyin:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.19.0")
}

Kitaplıktaki yardımcı programlardan birini kullanın. Örneğin, işaretçi kümeleme, ısı haritaları veya diğer yardımcı programlar.

2. adım: (İsteğe bağlı) Android için Haritalar SDK'sının yardımcı program KTX kitaplığını yükleyin.

Android için Haritalar SDK'sı yardımcı program kitaplığı, ilgili bir Kotlin uzantıları (KTX) kitaplığıyla birlikte gelir. Bu kitaplık, Kotlin dilinde kısa ve deyimsel kod yazmanızı sağlamak için uzantı işlevleri, adlandırılmış ve varsayılan bağımsız değişkenler gibi Kotlin dil özelliklerini sunar. Kotlin ile geliştirme yapmıyorsanız bu adımı atlayabilirsiniz.

Bu kitaplığı kullanmak için android-maps-utils bağımlılığına ek olarak aşağıdaki bağımlılığı uygulamanızın build.gradle.kts dosyasına ekleyin:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

Bu kitaplık hakkında daha fazla bilgi için Maps KTX GitHub sayfasını ziyaret edin.

3. Adım: Android için Haritalar SDK'sı yardımcı program kitaplığının kaynak kodunu görüntüleme

Yardımcı program kitaplığı açık kaynaklı olduğundan, android-maps-utils kitaplığını makinenize indirerek özelleştirebilir, demo uygulamasını görüntüleyebilir veya kitaplığın nasıl çalıştığını anlayabilirsiniz. Bunu, depoyu klonlayarak (otomatik güncellemeleri almak için önerilir) veya bir zip dosyası indirerek yapabilirsiniz. Kitaplığı özelleştirmek istiyorsanız depoyu çatallamanız gerekir.

Depo şunları içerir:

  • demo dizininde bir demo uygulaması.
  • library dizinindeki yardımcı program kitaplığı.
  • Lisans, katkıda bulunanlar ve benioku bilgilerini içeren çeşitli dosyalar.
  • Android Studio ile kullanılmak üzere Gradle derleme yapılandırması.

Yardımcı program demo uygulamasını çalıştırma

Yardımcı kitaplığının GitHub deposunda, her yardımcı programın örnek uygulamalarını içeren bir demo uygulaması bulunur. Demo uygulamasını Android cihazınızda çalıştırmak için aşağıdaki adımları uygulayın.

  1. Yukarıda belirtilen seçeneklerden birini kullanarak depoyu indirin.
  2. Android Studio'da File -> New -> Import Project'i (Dosya -> Yeni -> Projeyi İçe Aktar) seçin.
  3. Yardımcı program kitaplığını klonladığınızda oluşturulan android-maps-utils dizinine gidip bu dizini seçin (çift tıklayın). Android Studio artık projeyi oluşturur.
  4. Emülatör yerine Android cihaz kullanıyorsanız geliştirici modunu etkinleştirdiğinizden emin olun. Ardından, Android cihazı bilgisayarınıza bağlayın.

  5. local.properties dosyasına şu şekilde tek bir satır ekleyin:

    MAPS_API_KEY=YOUR_API_KEY

    Burada YOUR_API_KEY, API anahtarlarını kullanma bölümünde açıklandığı şekilde aldığınız API anahtarıdır.

  6. Demo uygulamasını oluşturup çalıştırın.

Uygulama, Android cihazda açılmalı ve kümeleme, çoklu yardımcı program, ısı haritası gibi yardımcı programların listesini göstermelidir. Uygulamayı, uygulama listenizde Maps Utils Demo adıyla da bulabilirsiniz.