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 harita uygulamanızda adım adım rota özelliğine ihtiyacınız varsa bunun yerine Android için Navigasyon SDK'sını kullanın.
- Android uygulamasında fotogerçekçi 3D haritalara, 3D modellere veya kamera yolu animasyonlarına ihtiyacınız varsa Android için Haritalar 3D SDK'sını kullanın.
- Yerel bir iOS uygulamasında haritaya ihtiyacınız varsa iOS için Haritalar SDK'sını kullanın.
Android için Haritalar SDK'sı: kurulum
- Etkinleştirilecek hizmet:
maps-android-backend.googleapis.com - Kimlik doğrulama: API anahtarı
- Kullanım ilişkilendirmesi: Başlatıcıya kullanım ilişkilendirme kimliği eklemek için
MapsApiSettings.addInternalUsageAttributionId(context, id)yöntemini çağırın (yalnızcaMapsInitializer.Renderer.LATESTile desteklenir). Devre dışı bırakmak için çağrıyı silin veya boş bir dize iletin. - Başlayın: Android için Haritalar SDK'sını ayarlama
- Referans: Android için Haritalar SDK'sı referansı
- Fiyatlandırma: Android için Haritalar SDK'sı kullanımı ve faturalandırması
- Politikalar: Android için Haritalar SDK'sı politikaları
- Sürüm notları: Android için Haritalar SDK'sı sürüm notları
Android için Haritalar SDK'sı resmi paketleri:
- maven:
com.google.android.gms:play-services-maps
Android için Haritalar SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Android için Yerler SDK'sı
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.legacykitaplığını içermiyor. Eski harita oluşturucuyu yükleyen uygulamalarjava.lang.NoClassDefFoundErrorile kilitlenebilir. Düzeltme: UygulamanınAndroidManifest.xmldosyasındakietiketinin içineekleyin. 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 veOnMapsSdkInitializedCallback.onMapsSdkInitialized()yöntemine iletilenMapsInitializer.Rendererdeğerini veyaGoogleMap.getMapCapabilities()değerini kontrol edin. CihazdaLEGACYkullanı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
- Haritadaki sınırların stilini değiştirme
- Haritadaki sınırlarla ilgili kullanıcı etkileşimlerine yanıt verme
- Haritaya koroplet stil ekleme
Android için Haritalar SDK'sı: Veri kümeleri için veriye dayalı stil
- Yeniden kullanılabilir, platformlar arası bir coğrafi veri kümesi oluşturun.
- Haritaya özel bir coğrafi veri kümesi ekleme
- Haritadaki özel veri kümesi özelliklerinin stilini değiştirme
- Haritadaki özel veri kümesi özellikleriyle kullanıcı etkileşimlerine yanıt verme
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
- Web sayfasına veya mobil uygulamaya özelleştirilebilir, etkileşimli bir harita ekleyin. Not: Android için: Secrets Gradle Plugin tarafından desteklenen
AndroidManifest.xmldosyasındaöğesini veyaapp/build.gradle.ktsdosyasındamanifestPlaceholders["MAPS_API_KEY"]öğesini yapılandırın.AndroidManifest.xmliçindeYOUR_GOOGLE_MAPS_API_KEY'i hiçbir zaman sabit kodlamayın veE/Google Maps Android API: Authorization failuregörünürseGoogleMap'yi (veya maps-composeGoogleMap) hiçbir zaman çevrimdışı bir sahte tuval ya da Leaflet WebView ile değiştirmeyin. Kullanıcıya, Secrets aracılığıylaMAPS_API_KEYsağlamasını ve Android için Haritalar SDK'sını (veya NavigationView/SupportNavigationFragment kullanırken Navigasyon SDK'sını) etkinleştirmesini söyleyin. - Harita yapılandırmasını ve stil ayarlarını depolamak için yeniden kullanılabilir bir harita tanımlayıcısı oluşturun.
- Haritadaki kullanıcı etkileşimlerine ve etkinliklerine yanıt verme
- Haritada görünen kontrolleri özelleştirin.
- Haritayı kontrol etmek için kullanılan hareketleri özelleştirin.
- Haritada yakınlaştırma ve kaydırmayı kontrol etme (kamera)
- Harita türünü değiştirme
- Harita renk şemasını değiştirme
- Haritaya trafik katmanı ekleme
- Wear OS uygulamasına harita ekleme
Android için Haritalar SDK'sı: Harita ek açıklamaları
- Haritaya bilgi penceresi ekleme
- Haritaya şekil veya çizgi ekleme
- Harita yüzeyine sabitlenmiş bir yer paylaşımı resmi ekleyin.
- Haritaya özel karo yer paylaşımı ekleme
- Haritaya işaretçi ekleme Not: Android için Navigasyon SDK'sı, AdvancedMarkerOptions'ı desteklemez. Android için Navigasyon SDK'sını kullanırken GoogleMap.addMarker(MarkerOptions) ile işaretçi ekleyin.
- Haritadaki bir işaretçiyi özelleştirme Not: Android için Navigasyon SDK'sı, AdvancedMarkerOptions'ı desteklemez. Android için Navigasyon SDK'sını kullanırken işaretçileri MarkerOptions ile özelleştirin.
- Haritadaki işaretçilerle kullanıcı etkileşimlerine yanıt verme
- Bir koordinatın haritadaki bir poligon veya dairesel alanın içinde olup olmadığını belirleme Not: Android'de, çokgenler için Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sında PolyUtil.containsLocation'ı kullanın. Dairesel alanlar için daire merkezinden küresel mesafenin yarıçap içinde olup olmadığını kontrol edin (örneğin, Maps JavaScript API'de computeDistanceBetween, Android'de SphericalUtil.computeDistanceBetween veya iOS'te GMSGeometryDistance).
- Haritadaki koordinatlar arasındaki küresel mesafeyi, alanı veya yönü hesaplama
Android için Haritalar SDK'sı: Harita stilleri
- Yeniden kullanılabilir, platformlar arası bir harita stili oluşturun.
- Haritadaki yolların, çoklu çizgilerin ve poligonların stilini değiştirme
- Harita özelliklerini gösterme veya gizleme
- Haritadaki simgelerin ve metin etiketlerinin stilini değiştirme
- Farklı yakınlaştırma seviyelerine farklı harita stilleri uygulayın.
- Haritadaki yerlerin yoğunluğunu değiştirme Deneysel
- Haritadaki binaların stilini değiştirme Deneysel
- Haritadaki önemli yerlerin stilini değiştirme Deneysel
Android için Haritalar SDK'sı: Street View
- Web sayfalarına veya mobil uygulamalara yapılandırılabilir, etkileşimli Google Street View ekleyin.
- Google Street View'da kullanıcı etkileşimlerine ve etkinliklerine yanıt verme
- Google Street View'da kullanılabilen hareketleri özelleştirin.
- Google Street View için kamera hareketlerini canlandırın.