Memulai

Pilih platform: Android iOS JavaScript

Ikuti langkah-langkah berikut untuk menyiapkan gaya visual berbasis data untuk batas.

Mengaktifkan perender peta baru

Perender peta yang diupgrade tersedia mulai Maps SDK for Android versi 18.0.0. Perender ini menghadirkan banyak peningkatan, termasuk dukungan untuk Gaya visual peta berbasis Cloud, ke Maps SDK for Android.

Dengan dirilisnya Maps SDK for Android versi 18.2.0, Google mengalihkan perender default dari perender lama ke perender peta yang diupgrade. Dengan perubahan ini, perender peta yang diupgrade kini digunakan secara default di aplikasi Anda saat Anda membuat aplikasi baru atau membuat ulang aplikasi yang sudah ada.

Perhatian: Untuk menggunakan gaya visual berbasis data untuk batas di aplikasi, aplikasi Anda harus dibuat menggunakan perender peta yang diupgrade. Jika Anda menambahkan gaya visual berbasis data untuk batas bagi aplikasi yang sudah ada, pastikan Anda membangun ulang agar aplikasi Anda menggunakan perender peta yang diupgrade. Untuk mendapatkan informasi lebih lanjut, lihat Perender Peta Baru.

Membuat ID peta

Untuk membuat ID peta baru, ikuti langkah-langkah di bagian Membuat ID peta. Pastikan Anda menetapkan "Jenis peta" keAndroid.

Membuat gaya peta baru

Untuk membuat gaya peta baru, ikuti petunjuk di bagian Mengelola gaya peta untuk membuat gaya, dan mengaitkan gaya dengan ID peta yang baru saja Anda buat.

Memilih lapisan fitur di gaya peta baru

Di Konsol API Google, Anda dapat memilih lapisan fitur mana yang akan ditampilkan untuk gaya peta baru Anda. Lapisan fitur menentukan jenis batas yang muncul di peta (misalnya lokalitas, negara bagian, dan sebagainya).

Penting: Untuk mendapatkan performa yang optimal, hanya pilih lapisan yang Anda perlukan.

1. Di Konsol API Google, buka halaman Map Styles.
2. Pilih project jika diminta.
3. Pilih gaya peta.
4. Klik drop-down Feature layers untuk menambahkan atau menghapus lapisan.
5. Klik Save untuk menyimpan perubahan dan menyediakannya untuk peta Anda.

Memperbarui kode inisialisasi peta

Langkah ini memerlukan ID peta yang baru saja Anda buat. Ini dapat ditemukan di Pengelolaan Maps.

Untuk menambahkan ID peta ke kode inisialisasi Anda, lihat bagian Menambahkan ID Peta ke aplikasi Anda.

Mendapatkan akses ke lapisan fitur peta

Anda menggunakan FeatureLayer untuk mewakili setiap lapisan fitur peta, seperti Kode Pos atau Lapisan fitur lokalitas. Untuk mendapatkan akses ke objek lapisan fitur, panggil GoogleMap.getFeatureLayer() saat peta melakukan inisialisasi:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Teruskan objek FeatureLayerOptions ke getFeatureLayer() untuk menentukan jenis lapisan fitur. Di sini misalnya, Anda ingin mengakses lapisan POSTAL_CODE. Buat objek FeatureLayer yang berbeda untuk setiap lapisan yang ingin Anda beri gaya.

Setelah memiliki objek FeatureLayer, Anda dapat menerapkan gaya visual ke poligon batas pada fitur tersebut.

Catatan: Jika FeatureLayer dari jenis yang ditentukan tidak ada untuk peta, atau jika gaya visual berbasis data untuk batas tidak diaktifkan karena Anda belum menentukan ID peta, panggilan ini akan menampilkan tetapi akan mencatat error. Gunakan metode FeatureLayer.isAvailable() untuk menentukan apakah FeatureLayer tersedia.

Memeriksa kemampuan peta (wajib)

Gaya visual berbasis data untuk batas memerlukan ID peta. Jika ID peta tidak ada, atau ID peta yang tidak valid diteruskan, gaya visual berbasis data untuk batas tidak dapat dimuat. Sebagai langkah pemecahan masalah, Anda dapat menggunakan MapCapabilities untuk memeriksa apakah gaya visual berbasis data untuk batas didukung.

Perhatian: Sebagian perangkat mungkin tidak mendukung perender peta baru sehingga tidak dapat menampilkan gaya visual berbasis data untuk batas. Anda harus menggunakan MapCapabilities untuk memeriksa dukungan pada saat runtime. Jika gaya visual berbasis data untuk batas tidak didukung, tentukan opsi penggantian. Guna mengetahui persyaratan perangkat untuk perender peta baru, lihat bagian Didukung perangkat tambahan.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());