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

เลือกแพลตฟอร์ม แอนดรอยด์ 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)