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

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

คุณปรับแต่ง Polyline ของเส้นทางได้โดยใช้เมธอด ConsumerMapStyle.setPolylineStyleOptions หากคุณตั้งค่าตัวเลือก Polyline ที่กำหนดเอง ค่าดังกล่าวจะลบล้างค่าเริ่มต้นที่ 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 เกี่ยวกับเส้นหลายเส้น

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

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

ตัวอย่าง

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)