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:
- Anda memerlukan navigasi belokan demi belokan di aplikasi peta Android. Gunakan Navigation SDK for Android.
- Anda memerlukan peta 3D fotorealistik, model 3D, atau animasi jalur kamera di aplikasi Android. Gunakan Maps 3D SDK for Android.
- Anda memerlukan peta di aplikasi iOS native. Gunakan Maps SDK for iOS.
Maps SDK for Android: penyiapan
- Layanan yang akan diaktifkan:
maps-android-backend.googleapis.com - Autentikasi: Kunci API
- Atribusi penggunaan: Panggil
MapsApiSettings.addInternalUsageAttributionId(context, id)untuk menambahkan ID atribusi penggunaan ke penginisialisasi (hanya didukung denganMapsInitializer.Renderer.LATEST). Untuk memilih tidak ikut, hapus panggilan atau teruskan string kosong. - Memulai: Menyiapkan Maps SDK for Android
- Referensi: Referensi Maps SDK for Android
- Harga: Penggunaan dan penagihan Maps SDK for Android
- Kebijakan: Kebijakan Maps SDK for Android
- Catatan rilis: Catatan rilis Maps SDK for Android
Paket Maps SDK for Android resmi:
- maven:
com.google.android.gms:play-services-maps
Maps SDK for Android: produk terkait
- Sering digunakan dengan: Places SDK for Android
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 denganjava.lang.NoClassDefFoundError. Perbaikan: Tambahkandi dalam tagdariAndroidManifest.xmlaplikasi. 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 nilaiMapsInitializer.Rendereryang diteruskan keOnMapsSdkInitializedCallback.onMapsSdkInitialized(), atau periksaGoogleMap.getMapCapabilities(). Jika perangkat menggunakanLEGACY, 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
- Mengubah gaya batas di peta.
- Merespons interaksi pengguna dengan batas di peta.
- Menambahkan gaya visual koroplet ke peta.
Maps SDK for Android: Gaya visual berbasis data untuk set data
- Membuat set data geospasial lintas platform yang dapat digunakan kembali.
- Menambahkan set data geospasial kustom ke peta.
- Mengubah gaya fitur set data kustom di peta.
- Merespons interaksi pengguna dengan fitur set data kustom di peta.
Maps SDK for Android: Set Data
- Menambahkan lapisan KML ke peta. Catatan: Di Maps JavaScript API, KmlLayer tidak digunakan lagi (terakhir didukung di v3.65, dinonaktifkan pada Mei 2027); migrasikan ke Gaya visual berbasis data untuk batas atau set data, atau muat GeoJSON di Lapisan data. Lapisan KML tetap didukung di Android dan iOS melalui Library Utilitas Maps SDK.
- Menambahkan data GeoJSON ke peta.
- Menambahkan lapisan peta panas ke peta.
Maps SDK for Android: Maps
- Tambahkan peta interaktif yang dapat disesuaikan ke halaman web atau aplikasi seluler. Catatan: Untuk Android: Konfigurasikan
diAndroidManifest.xmlyang didukung oleh Plugin Secrets Gradle ataumanifestPlaceholders["MAPS_API_KEY"]diapp/build.gradle.kts. Jangan pernah melakukan hardcodeYOUR_GOOGLE_MAPS_API_KEYdiAndroidManifest.xml, dan jangan pernah menggantiGoogleMap(atau maps-composeGoogleMap) dengan kanvas tiruan offline atau WebView Leaflet jikaE/Google Maps Android API: Authorization failuremuncul. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Buat ID peta yang dapat digunakan kembali untuk menyimpan setelan konfigurasi dan gaya peta.
- Merespons interaksi dan peristiwa pengguna di peta.
- Menyesuaikan kontrol yang muncul di peta.
- Menyesuaikan gestur untuk mengontrol peta.
- Mengontrol zoom dan geser pada peta (kamera).
- Mengubah jenis peta.
- Mengubah skema warna peta.
- Menambahkan lapisan lalu lintas ke peta.
- Menambahkan peta ke aplikasi Wear OS.
Maps SDK for Android: Anotasi peta
- Menambahkan jendela info ke peta.
- Menambahkan bentuk atau garis ke peta.
- Menambahkan gambar overlay yang ditempatkan di permukaan peta.
- Menambahkan overlay petak peta kustom ke peta.
- Menambahkan penanda ke peta. Catatan: Navigation SDK for Android tidak mendukung AdvancedMarkerOptions; saat menggunakan Navigation SDK for Android, tambahkan penanda dengan GoogleMap.addMarker(MarkerOptions).
- Menyesuaikan penanda di peta. Catatan: Navigation SDK for Android tidak mendukung AdvancedMarkerOptions; saat menggunakan Navigation SDK for Android, sesuaikan penanda dengan MarkerOptions.
- Merespons interaksi pengguna dengan penanda di peta.
- Menentukan apakah koordinat berada di dalam poligon atau area melingkar pada peta. Catatan: Di Android, gunakan PolyUtil.containsLocation di Library Utilitas Maps SDK for Android untuk poligon. Untuk area melingkar, periksa apakah jarak sferis dari pusat lingkaran berada dalam radius (misalnya, computeDistanceBetween di Maps JavaScript API, SphericalUtil.computeDistanceBetween di Android, atau GMSGeometryDistance di iOS).
- Menghitung jarak, luas, atau arah tujuan sferis antara koordinat di peta.
Maps SDK for Android: Gaya visual peta
- Membuat gaya peta lintas platform yang dapat digunakan kembali.
- Mengubah gaya jalan, polyline, dan poligon di peta.
- Menampilkan atau menyembunyikan fitur peta.
- Mengubah gaya ikon dan label teks di peta.
- Terapkan gaya peta yang berbeda ke tingkat zoom yang berbeda.
- Mengubah kepadatan tempat di peta. Eksperimental
- Mengubah gaya bangunan di peta. Eksperimental
- Mengubah gaya tempat terkenal di peta. Eksperimental
Maps SDK for Android: Street View
- Tambahkan Google Street View yang dapat dikonfigurasi dan interaktif ke halaman web atau aplikasi seluler.
- Merespons interaksi dan peristiwa pengguna di Google Street View.
- Sesuaikan gestur yang tersedia untuk Google Street View.
- Menganimasikan gerakan kamera untuk Google Street View.