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

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

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