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), dan beberapa fitur baru untuk Anda coba:

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

Panduan ini menunjukkan cara menggunakan fitur baru.

Penyesuaian Maps (beta)

Penyesuaian Maps menyediakan berbagai alat dan fitur yang membuat Anda lebih mudah menyesuaikan dan mengelola cara penataan gaya peta Anda. Daripada menata gaya peta Anda dalam kode menggunakan Maps API dan SDK, Anda dapat mengelola dan menata gaya peta Anda di Google Cloud Console. Untuk informasi selengkapnya, lihat Ringkasan Penyesuaian Peta Android.

Penanganan penanda yang tumpang-tindih (beta)

Anda dapat menentukan apakah penanda kustom harus mengganti label peta dasar default saat terjadi tumpang-tindih, dan untuk menunjukkan prioritas relatif antara 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:

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)));

      

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))
)

      

Membuat polyline gradien

Anda dapat menentukan gradien dengan menetapkan dua integer ARGB (alpha-red-green-blue) 32-bit, untuk menetapkan 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.

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())));

      

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()
            )
        )
)

      

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:

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));

      

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)
)

      

Mengimpor library utilitas yang kompatibel dengan versi beta

Jika Anda menggunakan library utilitas Google Maps Android API, Anda juga perlu memperbarui dependensi project untuk mengganti versi yang ada ke versi yang kompatibel dengan versi 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 sampel

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