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

Platform seçin: Android iOS

Bu sayfada, Android için Haritalar SDK'sı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üzeyi 15 ve sonraki sürümleri destekler. Proje derleme hedefinizi ayarlarken en son Android API düzeyini kullandığınızdan emin olun.

Referans belgeleri GitHub'da bulabilirsiniz.

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

Uygulamanızın build.gradle 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.8.0'
}

Kitaplıkta bulunan yardımcı programlardan birini (ör. işaretçi kümeleme, ısı haritaları veya diğer yardımcı programlar) kullanın.

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

Android için Haritalar SDK'sı yardımcı program kitaplığına karşılık gelen bir Kotlin uzantıları (KTX) kitaplığı bulunur. Bu kitaplık, kısa ve deyimsel Kotlin yazabilmenizi sağlamak için uzantı işlevleri, adlandırılmış ve varsayılan bağımsız değişkenler gibi Kotlin dili özellikleri sunar. Kotlin'de 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 dosyasına ekleyin:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.0.0'
}

Bu kitaplık hakkında ek bilgi için Haritalar KTX GitHub sayfasına göz atın.

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 kaynak olduğundan programı özelleştirmek, demo uygulamasını görüntülemek veya kitaplığın nasıl çalıştığını anlamak için android-maps-utils kitaplığını makinenize indirebilirsiniz. Bunu depoyu klonlayarak (otomatik güncellemeler almak için önerilir) veya bir zip dosyası indirerek yapabilirsiniz. Kitaplığı özelleştirmek istiyorsanız depoyu çatallamanız gerekir.

Bu kod deposunda şunlar bulunur:

  • demo dizininde bir demo uygulama.
  • 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ı program kütüphanesinin GitHub deposu, her yardımcı programın örnek uygulamalarını içeren bir demo uygulamasıyla birlikte gelir. Demo uygulamayı Android cihazınızda çalıştırmak için aşağıdaki adımları uygulayın.

  1. Yukarıda belirtilen seçeneklerden birini kullanarak kod deposunu indirin.
  2. Android Studio'da Dosya -> Yeni -> Projeyi İçe Aktar'ı seçin.
  3. Yardımcı program kitaplığını klonladığınızda oluşturulan android-maps-utils dizinini bulup seçin (çift tıklayın). Android Studio artık projeyi derlemektedir.
  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 takın.

  5. local.properties içine şuna benzer tek bir satır ekleyin:

    MAPS_API_KEY=YOUR_API_KEY

    YOUR_API_KEY, API Anahtarlarını Kullanma bölümünde açıklandığı şekilde edindiğiniz API anahtarıdır.

  6. demo uygulamasını derleyip çalıştırın.

Uygulama Android cihazda açılır. Kümeleme, poyutil, ısı haritası vb. yardımcı programların listesi görüntülenir. Uygulamayı, uygulama listenizde Haritalar Yardımcı Programlar Demosu adının altında da bulabilirsiniz.