Menyesuaikan polyline rute

Pilih platform: Android iOS JavaScript

Anda menyesuaikan polyline rute menggunakan metode ConsumerMapStyle.setPolylineStyleOptions. Jika Anda menetapkan opsi polyline kustom, opsi tersebut akan menggantikan nilai default yang disediakan oleh Consumer SDK.

Untuk memulihkan nilai default, panggil setPolylineStyleOptions dengan null untuk parameter PolylineOptions.

Untuk mengambil PolylineOptions aktif, gunakan metode getPolylineStyleOptions.

Untuk mengetahui informasi selengkapnya, lihat ConsumerMapStyle.setPolylineStyleOptions.

Jenis polyline rute

Anda dapat menyesuaikan jenis polyline rute berikut:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE dan REMAINING_ROUTE ditampilkan saat mengikuti perjalanan dan mewakili rute kendaraan.

Properti polyline rute

Google Maps menyediakan properti yang dapat disesuaikan untuk setiap polyline di PolylineOptions.

  • Untuk membuat PolylineOptions, gunakan konstruktornya.

  • Untuk menentukan properti yang disesuaikan, gunakan metode gaya 'Setter'. Karena metode ini menyediakan nilai default untuk setiap properti, Anda hanya perlu menentukan nilai kustom.

  • Untuk menonaktifkan polyline, tetapkan visible ke false.

Untuk mengetahui detail selengkapnya, lihat PolylineOptions di dokumentasi developer Android.

Contoh

Java

// Initializing polyline style options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .visible(false));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);

Kotlin

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setPolylineStyleOptions(
      PolylineType.ACTIVE_ROUTE,
      PolylineOptions().visible(false)
    )
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

Rute Aktif dan Tersisa

Dengan mengaktifkan berbagi perjalanan, aplikasi Anda dapat menyesuaikan pengalaman pengguna menggunakan polyline untuk menampilkan rute aktif dan rute yang tersisa untuk kendaraan Anda.

  • Rute aktif adalah jalur yang dilalui kendaraan saat ini untuk mencapai titik jalan berikutnya dalam perjalanan aktif konsumen.

  • Rute yang tersisa adalah jalur yang masih harus dilalui kendaraan setelah melewati rute aktif. Jika titik jalan rute aktif adalah titik jalan perjalanan terakhir, rute yang tersisa tidak ada.

Anda dapat menyesuaikan dan mengontrol visibilitas polyline aktif dan yang tersisa di aplikasi Anda. Secara default, rute aktif terlihat dan rute yang tersisa tidak terlihat.

Contoh

Java

// Initializing polyline options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .color(Color.BLUE));
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.REMAINING_ROUTE,
              new PolylineOptions()
                  .color(Color.BLACK)
                  .width(5)
                  .visible(true));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);
consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null);

Kotlin

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    {
      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.ACTIVE_ROUTE,
        PolylineOptions().color(Color.BLUE)
      )

      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.REMAINING_ROUTE,
        PolylineOptions().color(Color.BLACK).width(5).visible(true)
      )
    }
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null)

Polyline yang mengetahui kondisi lalu lintas

Lapisan traffic polyline dinonaktifkan secara default. Jika Anda mengaktifkannya, perender akan menggambar segmen di atas polyline rute yang merepresentasikan rentang lalu lintas tidak normal. Rute ini mencakup selisih waktu, bergantung pada kondisi lalu lintas. Lihat dokumentasi Android Developer untuk Polyline untuk mengetahui informasi selengkapnya.

Google Maps menampilkan kondisi lalu lintas sebagai salah satu dari empat jenis kecepatan. Anda dapat menyesuaikan warna untuk setiap jenis kecepatan.

Untuk mengaktifkan polyline yang mengetahui traffic, buat objek TrafficStyle lalu teruskan ke ConsumerMapStyle dengan memanggil setPolylineTrafficStyle().

Contoh

Java

// TrafficStyle is part of the Consumer SDK.
int orange = Color.rgb(255, 165, 0);
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW, orange)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

Kotlin

// TrafficStyle is part of the Consumer SDK.
val orange = Color.rgb(255, 165, 0)
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GRAY)
    .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW, orange)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)