Menyesuaikan polyline rute

Pilih platform: Android iOS JavaScript

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

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

Untuk mengambil PolylineOptions yang 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 selama berbagi perjalanan dan yang mewakili rute kendaraan.

Properti polyline rute

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

  • Untuk membangun PolylineOptions, gunakan konstruktornya.

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

  • Untuk menonaktifkan polyline, tetapkan visible ke false.

Untuk 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 ke kendaraan Anda.

  • Rute aktif adalah jalur yang sekarang akan dituju kendaraan titik jalan berikutnya dalam perjalanan aktif konsumen.

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

Anda bisa menyesuaikan dan mengontrol visibilitas polyline yang aktif dan 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 berbasis traffic

Lapisan traffic polyline dinonaktifkan secara default. Saat Anda mengaktifkannya, perender menggambar segmen di atas polyline rute yang mewakili bentangan lalu lintas yang tidak normal. Ini mencakup offset yang bergantung pada kondisi lalu lintas. Lihat dokumentasi Android Developer untuk Polyline guna mendapatkan informasi selengkapnya.

Peta Google mewakili kondisi lalu lintas sebagai salah satu empat jenis kecepatan. Anda dapat menyesuaikan warna untuk setiap jenis kecepatan.

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

Contoh

Java

// TrafficStyle is part of the Consumer SDK.
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

Kotlin

// TrafficStyle is part of the Consumer SDK.
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
    .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)