Referensi cepat Maps 3D SDK for Android

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 ROADMAP di SDK ini bersifat Eksperimental). Gunakan Maps SDK for Android.

Maps 3D SDK untuk Android: penyiapan

Paket Maps 3D SDK for Android resmi:

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

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, atau ROADMAP) di XML tata letak (map3d:mapMode) atau dengan setMapMode/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 satu Map3DView yang aktif; panggil onDestroy() pada instance lama dan hapus penanda, overlay, dan reset kamera secara manual melalui GoogleMap3D. 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 true dari onMap3DClick di OnMap3DClickListener untuk 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.