Menggunakan Maps SDK for Android v3.1.0 versi BETA

Maps SDK for Android 3.1.0 versi beta adalah sebuah penerapan baru dengan platform API yang sama seperti versi sebelumnya (semua class dan metode tetap sama), serta beberapa fitur baru untuk Anda coba:

  • Penyesuaian peta
  • Penanganan penanda yang tumpang-tindih
  • Penyesuaian polyline

Panduan ini menunjukkan cara menggunakan fitur baru.

Penyesuaian Maps (beta)

Gaya visual peta berbasis cloud memberikan berbagai alat dan fitur yang mempermudah Anda menyesuaikan dan mengelola cara menata gaya peta. Daripada menata gaya peta Anda dalam kode menggunakan API dan SDK Maps, Anda dapat mengelola dan menata gaya peta Anda di Konsol Google Cloud. Untuk informasi selengkapnya, lihat Ringkasan Penyesuaian Peta Android.

Penanganan penanda yang tumpang-tindih (beta)

Anda dapat menentukan apakah penanda kustom akan menggantikan label peta dasar default saat terjadi konflik, dan untuk menunjukkan prioritas relatif di antara berbagai penanda kustom. Untuk informasi selengkapnya, lihat Penanganan Penanda yang Tumpang-Tindih (Android).

Penyesuaian Polyline (beta)

Sekarang ada beberapa cara baru untuk menyesuaikan tampilan polyline:

  • Polyline warna-warni menetapkan segmen polyline ke berbagai warna.
  • Polyline gradien memberi warna pada polyline menggunakan gradien dua warna.
  • Polyline berstempel menentukan gaya polyline menggunakan bitmap berulang.

Membuat polyline warna-warni

Anda dapat menggunakan span untuk mewarnai masing-masing segmen polyline, dengan membuat objek StyleSpan dan menambahkannya ke PolylineOptions menggunakan metode addSpan() atau addSpans(). Secara default, setiap item dalam array akan menetapkan warna segmen garis yang sesuai. Contoh berikut menunjukkan setelan warna segmen untuk membuat polyline dengan segmen merah dan hijau:

Kotlin



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

Membuat polyline gradien

Anda dapat menentukan gradien dengan menetapkan dua integer ARGB (alpha-red-green-blue) 32-bit, masing-masing sebagai warna awal dan akhir goresan. Tetapkan properti ini pada objek opsi bentuk dengan memanggil PolylineOptions.addSpan(). Contoh berikut menunjukkan pembuatan polyline gradien merah ke kuning dari Woodland Park Zoo ke Kirkland, WA.

Kotlin



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

Membuat polyline berstempel

Anda dapat menetapkan tampilan polyline ke tekstur bitmap berulang. Untuk melakukannya, buat StampStyle dari TextureStyle, lalu tetapkan properti ini pada objek opsi bentuk dengan memanggil PolylineOptions.addSpan() seperti yang ditunjukkan di sini:

Kotlin



val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

Java


StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

Mengimpor library utilitas yang kompatibel dengan versi beta

Jika menggunakan library utilitas Google Maps Android API, Anda juga perlu memperbarui dependensi project untuk mengganti versi yang ada ke versi yang kompatibel dengan beta menggunakan cara berikut:

  1. Impor library utilitas yang kompatibel dengan versi beta di file build.gradle Anda: 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. Hapus hal berikut dari build.gradle untuk menghapus library utilitas yang tidak kompatibel dengan versi beta: 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

Menjalankan contoh

Repositori Google Samples di GitHub berisi aplikasi contoh yang menunjukkan penggunaan Maps SDK for Android v3.1.0 versi Beta.