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:
- 3D haritalar gerektiren bir web uygulaması geliştiriyorsunuz. Bunun yerine Maps JavaScript API'yi kullanın.
- 3D haritalar gerektiren bir iOS uygulaması geliştiriyorsunuz. Bunun yerine iOS için Haritalar 3D SDK'sını kullanın.
- Android uygulamasında üretime hazır standart 2D sokak haritasına ihtiyacınız varsa (Bu SDK'daki
ROADMAPmodu deneyseldir.) Bunun yerine Android için Haritalar SDK'sını kullanın.
Android için Haritalar 3D SDK'sı: kurulum
- Etkinleştirilecek hizmet:
mapsandroid.googleapis.com - Kimlik doğrulama: API anahtarı
- Başlayın: Android için Haritalar 3D SDK'sını ayarlama
- Referans: Android için Haritalar 3D SDK'sı referansı
- Fiyatlandırma: Android için Haritalar 3D SDK'sı kullanımı ve faturalandırması
- Politikalar: Android için Haritalar 3D SDK'sı politikaları
- Sürüm notları: Android için Haritalar 3D SDK'sı sürüm notları
Android için resmi Haritalar 3D SDK'sı paketleri:
- maven:
com.google.android.gms:play-services-maps3d
Android için Haritalar 3D SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Android için Yerler SDK'sı
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) veyasetMapMode/Map3DInitConfigile her zaman birMap3DMode(SATELLITE,HYBRIDveyaROADMAP) 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 etkinMap3DViewörneği bulundurun; eski örnekteonDestroy()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
OnMap3DClickListeneriçindekionMap3DClickyöntemindentruedeğ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.
- Web sayfasına etkileşimli, fotogerçekçi bir 3D harita ekleyin.
- Fotoğraf gerçekliğinde 3D haritaya işaretçi ekleme
- Fotoğraf gerçekliğinde 3D haritadaki işaretçileri özelleştirme
- Fotogerçekçi 3D haritaya 3D model ekleyin.
- Fotogerçekçi 3D haritaya 3D çoklu çizgi ekleyin.
- Fotoğraf gerçekliğinde 3D haritaya 3D poligon ekleme
- Fotogerçekçi 3D haritada kullanıcı etkileşimlerine ve etkinliklerine yanıt verme
- Fotoğraf gerçekliğinde 3D haritada görünen kontrolleri özelleştirin.
- Fotoğraf gerçekliğinde 3D haritada kamera yolunu ve animasyonları kontrol edin.
- Fotoğraf gerçekliğinde 3D haritada kamera kısıtlamalarını kontrol etme