ปรับแต่งเส้นประกอบเส้นทาง

เลือกแพลตฟอร์ม Android iOS JavaScript

คุณปรับแต่งเส้นประกอบของเส้นทางได้โดยใช้เมธอด ConsumerMapStyle.setPolylineStyleOptions หากคุณตั้งค่าตัวเลือกเส้นประกอบที่กําหนดเอง ระบบจะลบล้างค่าเริ่มต้นที่ Consumer SDK ระบุ

หากต้องการคืนค่าเริ่มต้น ให้เรียกใช้ setPolylineStyleOptions ด้วย null สำหรับพารามิเตอร์ PolylineOptions

หากต้องการเรียกข้อมูล PolylineOptions ที่ใช้งานอยู่ ให้ใช้วิธี getPolylineStyleOptions

ดูข้อมูลเพิ่มเติมได้ที่ ConsumerMapStyle.setPolylineStyleOptions

ประเภทโพลีไลน์ของเส้นทาง

คุณปรับแต่งประเภทเส้นประกอบของเส้นทางต่อไปนี้ได้

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE และ REMAINING_ROUTE จะแสดงขณะติดตามการเดินทางและแสดงเส้นทางของยานพาหนะ

คุณสมบัติเส้นประกอบของเส้นทาง

Google Maps มีพร็อพเพอร์ตี้ที่ปรับแต่งได้สำหรับเส้นประกอบแต่ละเส้นใน PolylineOptions

  • หากต้องการสร้าง PolylineOptions ให้ใช้คอนสตรคเตอร์

  • หากต้องการระบุพร็อพเพอร์ตี้ที่กําหนดเอง ให้ใช้เมธอดสไตล์ "Setter" เนื่องจากเมธอดมีค่าเริ่มต้นสําหรับพร็อพเพอร์ตี้แต่ละรายการ คุณจึงต้องระบุเฉพาะค่าที่กําหนดเองเท่านั้น

  • หากต้องการปิดเส้นประกอบ ให้ตั้งค่า visible เป็น false

ดูรายละเอียดเพิ่มเติมได้ในส่วน PolylineOptions ในเอกสารประกอบสำหรับนักพัฒนาแอป Android

ตัวอย่าง

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)

เส้นทางที่ใช้งานอยู่และเส้นทางที่เหลือ

เมื่อเปิดใช้การแชร์เส้นทาง แอปจะปรับแต่งประสบการณ์ของผู้ใช้โดยใช้เส้นประกอบเพื่อแสดงเส้นทางที่ใช้งานอยู่และเส้นทางที่เหลือสำหรับยานพาหนะ

  • เส้นทางที่ใช้งานอยู่คือเส้นทางที่ยานพาหนะกำลังเดินทางเพื่อไปยังจุดสังเกตถัดไปในการเดินทางที่ใช้งานอยู่ของผู้บริโภค

  • เส้นทางที่เหลือคือเส้นทางที่ยานพาหนะยังต้องเดินทางผ่านจากเส้นทางที่ใช้งานอยู่ เมื่อจุดสังเกตของเส้นทางที่ใช้งานอยู่เป็นจุดสังเกตของการเดินทางสุดท้าย จะไม่มีเส้นทางที่เหลืออยู่

คุณสามารถปรับแต่งและควบคุมการแสดงผลของเส้นประกอบที่ใช้งานอยู่และที่เหลือในแอป โดยค่าเริ่มต้น เส้นทางที่ใช้งานอยู่จะแสดงอยู่และเส้นทางที่เหลือจะมองไม่เห็น

ตัวอย่าง

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)

เส้นประกอบที่คำนึงถึงสภาพการจราจร

ระบบจะปิดใช้เลเยอร์การจราจรของเส้นประกอบไว้โดยค่าเริ่มต้น เมื่อเปิดใช้ โปรแกรมแสดงผลจะวาดส่วนของเส้นเหนือเส้นประกอบของเส้นทางซึ่งแสดงถึงช่วงที่มีปริมาณการจราจรผิดปกติ ซึ่งจะมีค่าออฟเซ็ตโดยขึ้นอยู่กับสภาพการจราจร ดูข้อมูลเพิ่มเติมในเอกสารประกอบสำหรับนักพัฒนาแอป Android เกี่ยวกับ Polyline

Google Maps แสดงสภาพการจราจรเป็นความเร็ว 4 ประเภท คุณปรับแต่งสีสำหรับความเร็วแต่ละประเภทได้

หากต้องการเปิดใช้เส้นประกอบที่คำนึงถึงสภาพการจราจร ให้สร้างออบเจ็กต์ TrafficStyle แล้วส่งไปยัง ConsumerMapStyle โดยการเรียกใช้ setPolylineTrafficStyle()

ตัวอย่าง

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)