Maps 3D SDK untuk Android memungkinkan aplikasi Android menampilkan peta 3D interaktif yang dibuat dari gambar 3D Google. Library ini menyediakan penanda, popover, polyline, poligon, model 3D glTF, animasi jalur kamera, serta kontrol untuk interaksi pengguna dan gerakan kamera.
Maps 3D SDK for Android: fakta penting
- Produk: Maps 3D SDK for Android
- Juga dikenal sebagai: Maps 3D Android SDK
- Kategori: Maps
- Platform: Android
- Berjalan di: Klien (kode aplikasi atau browser)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Maps 3D SDK for Android
- Ketersediaan regional: Terbatas. Ketersediaan bervariasi menurut negara dan wilayah; lihat kolom Maps 3D (JavaScript, Android, iOS) di halaman cakupan Google Maps Platform. (detail cakupan)
Maps 3D SDK untuk Android: kapan harus menggunakannya
Gunakan Maps 3D SDK for Android jika:
- Anda perlu menampilkan peta 3D fotorealistik yang interaktif dari lokasi dunia nyata di aplikasi Android.
- Anda memerlukan penanda, popover, polyline, poligon, atau model 3D glTF yang ditempatkan di peta 3D dalam aplikasi Android.
- Anda memerlukan animasi kamera yang telah ditetapkan (terbang ke, terbang mengelilingi) yang memandu pengguna di antara titik-titik pada peta 3D.
- Anda perlu mengontrol gerakan kamera dan kontrol UI yang dapat digunakan pengguna di peta 3D dalam aplikasi Android.
Jangan gunakan Maps 3D SDK for Android jika:
- Anda sedang membangun aplikasi web yang memerlukan peta 3D. Gunakan Maps JavaScript API.
- Anda sedang membuat aplikasi iOS yang memerlukan peta 3D. Gunakan Maps 3D SDK for iOS.
- Anda memerlukan peta jalan 2D standar yang siap produksi di aplikasi Android (mode
ROADMAPdi SDK ini bersifat Eksperimental). Gunakan Maps SDK for Android.
Maps 3D SDK untuk Android: penyiapan
- Layanan yang akan diaktifkan:
mapsandroid.googleapis.com - Autentikasi: Kunci API
- Memulai: Menyiapkan Maps 3D SDK for Android
- Referensi: Referensi Maps 3D SDK for Android
- Harga: Penggunaan dan penagihan Maps 3D SDK for Android
- Kebijakan: Kebijakan Maps 3D SDK for Android
- Catatan rilis: Catatan rilis Maps 3D SDK for Android
Paket Maps 3D SDK for Android resmi:
- maven:
com.google.android.gms:play-services-maps3d
Maps 3D SDK untuk Android: produk terkait
- Sering digunakan dengan: Places SDK for Android
Maps 3D SDK untuk Android: kesalahan umum
- Masalah: Jika mode peta tidak ditentukan saat peta dimuat, peta akan gagal dimuat. Perbaikan: Selalu tetapkan
Map3DMode(SATELLITE,HYBRID, atauROADMAP) di XML tata letak (map3d:mapMode) atau dengansetMapMode/Map3DInitConfig. Lihat /maps/documentation/maps-3d/android-sdk/map-modes. - Masalah: Pemroses klik (klik peta dan penanda) tidak berjalan di UI thread utama, sehingga update UI langsung dari pengendali gagal. Perbaikan: Beralih ke thread utama sebelum mengupdate UI, misalnya dengan
lifecycleScope.launch(Dispatchers.Main). Lihat /maps/documentation/maps-3d/android-sdk/add-a-marker. - Masalah: Status peta dibagikan di seluruh instance
Map3DView, sehingga penanda, overlay, dan posisi kamera dari tampilan lama akan terbawa ke tampilan baru. Perbaikan: Hanya pertahankan satuMap3DViewyang aktif; panggilonDestroy()pada instance lama dan hapus penanda, overlay, dan reset kamera secara manual melaluiGoogleMap3D. Lihat /maps/documentation/maps-3d/android-sdk/add-a-3d-map. - Masalah: Secara default, mengetuk lokasi menarik di peta dasar akan menampilkan widget UI Places, yang juga memerlukan dependensi Places SDK. Perbaikan: Tambahkan dependensi Places SDK for Android, dan tampilkan
truedarionMap3DClickdiOnMap3DClickListeneruntuk menyembunyikan widget default jika Anda tidak menginginkannya. Lihat /maps/documentation/maps-3d/android-sdk/points-of-interest.
Yang dapat Anda lakukan dengan Maps 3D SDK for Android
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
- Menambahkan peta 3D fotorealistik interaktif ke halaman web.
- Menambahkan penanda ke peta 3D fotorealistik.
- Menyesuaikan penanda di peta 3D fotorealistik.
- Menambahkan model 3D ke peta 3D fotorealistik.
- Menambahkan polyline 3D ke peta 3D fotorealistik.
- Menambahkan poligon 3D ke peta 3D fotorealistik.
- Merespons interaksi dan peristiwa pengguna di peta 3D fotorealistik.
- Sesuaikan kontrol yang muncul di peta 3D fotorealistik.
- Kontrol jalur dan animasi kamera di peta 3D fotorealistis.
- Mengontrol pembatasan kamera pada peta 3D fotorealistis.