Android için Haritalar SDK'sı hızlı referansı

Android için Haritalar SDK'sı; Wear OS uygulamaları da dahil olmak üzere Android uygulamalarına Google Haritalar verileri, harita görüntüleri ve harita hareketlerine verilen yanıtlar ekler. Kotlin veya Java kullanarak harita konumları hakkında bilgi göstermek ve kullanıcı etkileşimini desteklemek için işaretçiler, poligonlar ve yer paylaşımları ekleyebilirsiniz.

Android için Haritalar SDK'sı: Önemli bilgiler

  • Ürün: Android için Haritalar SDK'sı
  • Diğer adları: Google Haritalar Android API
  • Kategori: Haritalar
  • Platform: Android
  • Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: Android için Haritalar SDK'sına genel bakış
  • Kullanılabildiği bölgeler: Dünya geneli. Google Haritalar Platformu kapsam sayfasını inceleyin. Kullanım ve faturalandırma sayfasında, dünya geneli ve Hindistan için ayrı fiyatlandırma listeleri bulunur. (kapsam ayrıntıları)

Android için Haritalar SDK'sı: Ne zaman kullanılır?

Android için Haritalar SDK'sını şu durumlarda kullanın:

  • Yerel bir Android veya Wear OS uygulamasında etkileşimli bir 2D Google haritasına ihtiyacınız varsa.
  • Bir Android uygulamasındaki haritaya işaretçiler, bilgi pencereleri, çoklu çizgiler, poligonlar, yer yer paylaşımları veya karo yer paylaşımları eklemeniz gerekiyor.
  • Android uygulamasında Street View panoramaları, basit mod (bit eşlem) haritaları veya harita kimlikleri içeren bulut tabanlı harita stilleri gerekir.
  • Haritalar Compose kitaplığı üzerinden Jetpack Compose da dahil olmak üzere Kotlin veya Java'da bir Android haritası oluşturursunuz.

Android için Haritalar SDK'sını şu durumlarda kullanmayın:

Android için Haritalar SDK'sı: kurulum

Android için Haritalar SDK'sı resmi paketleri:

  • maven: com.google.android.gms:play-services-maps

Android için Haritalar SDK'sı: Sık yapılan yanlışlar

  • Sorun: SDK v20.0.0 sürümünden itibaren SDK manifesti artık org.apache.http.legacy kitaplığını içermiyor. Eski harita oluşturucuyu yükleyen uygulamalar java.lang.NoClassDefFoundError ile kilitlenebilir. Düzeltme: Uygulamanın AndroidManifest.xml dosyasındaki etiketinin içine ekleyin. Google Play Hizmetleri 25.50.34 veya sonraki sürümlerin yüklü olduğu cihazlar bu durumdan etkilenmez. /maps/documentation/android-sdk/release-notes sayfasına göz atın.
  • Sorun: Gelişmiş işaretçiler için yeni harita oluşturucu gerekir. Bu özellikleri mevcut bir uygulamaya yeniden derlemeden eklerseniz uygulama eski oluşturucuyu kullanmaya devam edebilir. Düzeltme: Yükseltilen oluşturucunun varsayılan olması için uygulamayı SDK 18.2.0 veya sonraki bir sürümle yeniden derleyin. /maps/documentation/android-sdk/advanced-markers/start sayfasına bakın.
  • Sorun: Oluşturucu gereksinimlerini (Android 5.0/API 21 veya sonraki sürümler, Google Play Hizmetleri 21.39.14 veya sonraki sürümler, Play Store etkin) karşılamayan cihazlar eski oluşturucuya geri döner. Bu nedenle, bulut tabanlı harita stilleri gibi yeni oluşturucuyu gerektiren özellikler bu cihazlarda kullanılamaz. Düzeltme: MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) yöntemini çağırın ve OnMapsSdkInitializedCallback.onMapsSdkInitialized() yöntemine iletilen MapsInitializer.Renderer değerini veya GoogleMap.getMapCapabilities() değerini kontrol edin. Cihazda LEGACY kullanılıyorsa bulut tabanlı harita stillerini veya gelişmiş işaretçileri kullanmayın. /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback adresini inceleyin.
  • Sorun: SDK, uygulamanın çalıştığı cihazda Google Play Hizmetleri'nin bulunmasını gerektirir. Düzeltme: İsteğe bağlı olarak uygulamanızdan Google Play Hizmetleri kullanılabilirlik kontrolünü çağırın. /maps/documentation/android-sdk/config adresini inceleyin.

Android için Haritalar SDK'sı: eski ve desteği sonlandırılmış özellikler

  • Eski harita oluşturucu: 04.03.2024'ten itibaren desteği sonlandırıldı. Değişiklik: SDK 18.2.0'dan beri varsayılan olan yeni sürüme geçirilmiş (en yeni) harita oluşturucu. Belirti: Bulut tabanlı harita stilleri, gelişmiş çoklu çizgi özelleştirmeleri ve gelişmiş işaretçiler eski oluşturucuda kullanılamaz. Geçiş rehberini inceleyin.

Android için Haritalar SDK'sı ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.

Android için Haritalar SDK'sı: Sınırlar için veriye dayalı stil

Android için Haritalar SDK'sı: Veri kümeleri için veriye dayalı stil

Android için Haritalar SDK'sı: Veri kümeleri

  • Haritaya KML katmanı ekleme Not: Maps JavaScript API'de KmlLayer desteği sonlandırılmıştır (en son 3.65 sürümünde desteklenmiştir, Mayıs 2027'de kullanımdan kaldırılacaktır). Sınırlar veya veri kümeleri için veri odaklı stile geçin ya da veri katmanına GeoJSON yükleyin. KML katmanları, Haritalar SDK'sı Yardımcı Program Kitaplıkları aracılığıyla Android ve iOS'te desteklenmeye devam eder.
  • Haritaya GeoJSON verileri ekleme
  • Haritaya ısı haritası katmanı ekleme

Android için Haritalar SDK'sı: Haritalar

Android için Haritalar SDK'sı: Harita ek açıklamaları

Android için Haritalar SDK'sı: Harita stilleri

Android için Haritalar SDK'sı: Street View