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

Android için Haritalar 3D SDK'sı, Android uygulamalarının Google'ın 3D görüntülerinden oluşturulan etkileşimli 3D haritalar göstermesine olanak tanır. İşaretçiler, popover'lar, çoklu çizgiler, poligonlar, glTF 3D modeller, kamera yolu animasyonları ve kullanıcı etkileşimi ile kamera hareketi için kontroller sağlar.

Android için Maps 3D SDK: Önemli bilgiler

  • Ürün: Android için Haritalar 3D SDK'sı
  • Diğer adları: Maps 3D Android SDK
  • 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 3D SDK'sına genel bakış
  • Kullanılabildiği bölgeler: Sınırlı. Kullanılabilirlik durumu ülkeye ve bölgeye göre değişir. Google Haritalar Platformu kapsam sayfasındaki Haritalar 3D (JavaScript, Android, iOS) sütununa bakın. (kapsam ayrıntıları)

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

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

  • Bir Android uygulamasında gerçek dünyadaki konumların etkileşimli, foto-gerçekçi 3D haritasını göstermeniz gerekiyor.
  • Android uygulamasındaki 3D haritaya yerleştirilmiş işaretçiler, popover'lar, çoklu çizgiler, poligonlar veya glTF 3D modelleri kullanmanız gerekir.
  • Kullanıcıları 3D haritadaki noktalar arasında yönlendiren önceden tanımlanmış kamera animasyonlarına (uçarak gitme, uçarak dolaşma) ihtiyacınız vardır.
  • Bir Android uygulamasındaki 3D haritada kullanıcıların hangi kamera hareketlerini ve kullanıcı arayüzü kontrollerini kullanabileceğini kontrol etmeniz gerekiyor.

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

Android için Haritalar 3D SDK'sı: kurulum

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

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

Android için Haritalar 3D SDK'sı: Sık yapılan hatalar

  • Sorun: Harita yüklenirken harita modu belirtilmezse harita yüklenemez. Düzeltme: Düzen XML'inde (map3d:mapMode) veya setMapMode/Map3DInitConfig ile her zaman bir Map3DMode (SATELLITE, HYBRID veya ROADMAP) ayarlayın. /maps/documentation/maps-3d/android-sdk/map-modes adresini inceleyin.
  • Sorun: Tıklama işleyiciler (harita ve işaretçi tıklamaları) ana kullanıcı arayüzü iş parçacığında çalışmadığından, işleyiciden gelen doğrudan kullanıcı arayüzü güncellemeleri başarısız olur. Düzeltme: Kullanıcı arayüzünü güncellemeden önce ana iş parçacığına geçin (ör. lifecycleScope.launch(Dispatchers.Main) ile). /maps/documentation/maps-3d/android-sdk/add-a-marker sayfasına bakın.
  • Sorun: Harita durumu Map3DView örnek arasında paylaşıldığından eski bir görünümdeki işaretçiler, yer paylaşımları ve kamera konumu yeni görünüme taşınır. Düzeltme: Yalnızca bir etkin Map3DView örneği bulundurun; eski örnekte onDestroy() yöntemini çağırın ve işaretçiler ile yer paylaşımlarını manuel olarak temizleyip kamerayı GoogleMap3D üzerinden sıfırlayın. /maps/documentation/maps-3d/android-sdk/add-a-3d-map adresini ziyaret edin.
  • Sorun: Varsayılan olarak, temel haritadaki önemli yerlere dokunulduğunda Yerler kullanıcı arayüzü widget'ı gösterilir. Bu widget, Yerler SDK'sı bağımlılığını da gerektirir. Düzeltme: Android için Yerler SDK'sı bağımlılığını ekleyin ve varsayılan widget'ı istemiyorsanız gizlemek için OnMap3DClickListener içindeki onMap3DClick yönteminden true değerini döndürün. /maps/documentation/maps-3d/android-sdk/points-of-interest sayfasına bakın.

Android için Haritalar 3D 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.