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 mengganti nilai default yang disediakan oleh Consumer SDK.

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

Untuk mengambil PolylineOptions aktif, gunakan getPolylineStyleOptions metode.

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 dan tersedia 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 berbagi perjalanan diaktifkan, aplikasi Anda dapat menyesuaikan pengalaman pengguna menggunakan polyline untuk menampilkan rute aktif dan tersisa untuk kendaraan Anda.

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

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

Anda dapat menyesuaikan dan mengontrol visibilitas polyline aktif dan tersisa di aplikasi Anda. Secara default, rute aktif terlihat dan rute 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 lalu lintas polyline dinonaktifkan secara default. Jika Anda mengaktifkannya, perender akan menggambar segmen di atas polyline rute yang mewakili bentangan lalu lintas yang tidak normal. Lapisan ini mencakup offset yang bergantung pada kondisi lalu lintas. Lihat dokumentasi Developer Android untuk Polyline guna 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 kondisi lalu lintas, 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)