Referensi cepat Maps SDK for Android

Maps SDK for Android menambahkan data Google Maps, tampilan peta, dan respons gestur peta ke aplikasi Android, termasuk aplikasi Wear OS. Anda dapat menambahkan penanda, poligon, dan overlay untuk menampilkan informasi tentang lokasi peta dan mendukung interaksi pengguna, menggunakan Kotlin atau Java.

Maps SDK for Android: fakta penting

  • Produk: Maps SDK for Android
  • Juga dikenal sebagai: Google Maps Android API
  • Kategori: Maps
  • Platform: Android
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Maps SDK for Android
  • Ketersediaan regional: Global. Lihat halaman cakupan Google Maps Platform; link halaman penggunaan dan penagihan memisahkan daftar harga global dan India. (detail cakupan)

Maps SDK for Android: kapan harus menggunakannya

Gunakan Maps SDK for Android jika:

  • Anda memerlukan peta Google 2D interaktif di aplikasi Android atau Wear OS native.
  • Anda perlu menambahkan penanda, jendela info, polyline, poligon, overlay bumi, atau overlay ubin ke peta di aplikasi Android.
  • Anda memerlukan panorama Street View, peta mode ringan (bitmap), atau Gaya visual peta berbasis Cloud dengan ID peta di aplikasi Android.
  • Anda dapat membuat peta Android di Kotlin atau Java, termasuk Jetpack Compose melalui library Maps Compose.

Jangan gunakan Maps SDK for Android jika:

Maps SDK for Android: penyiapan

Paket Maps SDK for Android resmi:

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

Maps SDK for Android: kesalahan umum

  • Masalah: Sejak SDK v20.0.0, manifes SDK tidak lagi menyertakan library org.apache.http.legacy. Aplikasi yang memuat perender peta lama dapat mengalami error dengan java.lang.NoClassDefFoundError. Perbaikan: Tambahkan di dalam tag dari AndroidManifest.xml aplikasi. Perangkat dengan layanan Google Play 25.50.34 atau yang lebih baru tidak terpengaruh. Lihat /maps/documentation/android-sdk/release-notes.
  • Masalah: Penanda Lanjutan memerlukan perender peta yang diupgrade. Jika Anda menambahkannya ke aplikasi yang sudah ada tanpa membuat ulang aplikasi tersebut, aplikasi masih dapat menggunakan perender lama. Perbaikan: Build ulang aplikasi dengan SDK 18.2.0 atau yang lebih baru agar perender yang diupgrade menjadi default. Lihat /maps/documentation/android-sdk/advanced-markers/start.
  • Masalah: Perangkat yang tidak memenuhi persyaratan perender (Android 5.0/API 21 atau yang lebih baru, layanan Google Play 21.39.14 atau yang lebih baru, Google Play Store diaktifkan) akan kembali ke perender lama, sehingga fitur yang memerlukan perender baru, seperti Gaya visual peta berbasis cloud, tidak tersedia di perangkat tersebut. Perbaikan: Panggil MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) dan periksa nilai MapsInitializer.Renderer yang diteruskan ke OnMapsSdkInitializedCallback.onMapsSdkInitialized(), atau periksa GoogleMap.getMapCapabilities(). Jika perangkat menggunakan LEGACY, jangan mengandalkan Gaya visual peta berbasis Cloud atau Penanda Lanjutan. Lihat /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Masalah: SDK memerlukan layanan Google Play di perangkat tempat aplikasi berjalan. Perbaikan: Anda dapat memanggil pemeriksaan ketersediaan layanan Google Play dari aplikasi Anda. Lihat /maps/documentation/android-sdk/config.

Maps SDK for Android: fitur lama dan yang tidak digunakan lagi

  • Perender peta lama: Tidak digunakan lagi sejak 04-03-2024. Pengganti: Perender peta yang diupgrade (terbaru), yang merupakan default sejak SDK 18.2.0. Gejala: Gaya visual peta berbasis cloud, penyesuaian polyline lanjutan, dan Penanda Lanjutan tidak tersedia di perender lama. Lihat panduan migrasi.

Yang dapat Anda lakukan dengan Maps SDK for Android

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.

Maps SDK for Android: Gaya visual berbasis data untuk batas

Maps SDK for Android: Gaya visual berbasis data untuk set data

Maps SDK for Android: Set Data

Maps SDK for Android: Maps

Maps SDK for Android: Anotasi peta

Maps SDK for Android: Gaya visual peta

Maps SDK for Android: Street View