Trip and Order Progress

คลาส FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider ชั้นเรียน

ผู้ให้บริการตำแหน่งการเดินทาง

ชั้นเรียนนี้ขยายระยะเวลาถึง PollingLocationProvider

เข้าถึงโดยโทรไปที่ const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing") ดูไลบรารีใน Maps JavaScript API

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
พารามิเตอร์: 
สร้างผู้ให้บริการตำแหน่งใหม่สำหรับการเดินทาง Fleet Engine
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
พารามิเตอร์: 
  • paramsTripPolylineCustomizationFunctionParams พารามิเตอร์ที่มีให้ในฟังก์ชันการปรับแต่งเส้นประกอบ
ผลลัพธ์: ไม่มี
ฟังก์ชันปรับแต่งเส้นประกอบที่ให้สีเส้นประกอบแบบแอ็กทีฟตามการอ่านความเร็ว ระบุฟังก์ชันนี้เป็น FleetEngineTripLocationProviderOptions.activePolylineCustomization เพื่อแสดงผลเส้นประกอบที่รับรู้การรับส่งข้อมูลสำหรับเส้นประกอบที่ใช้งานอยู่
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
พารามิเตอร์: 
  • paramsTripPolylineCustomizationFunctionParams พารามิเตอร์ที่มีให้ในฟังก์ชันการปรับแต่งเส้นประกอบ
ผลลัพธ์: ไม่มี
ฟังก์ชันปรับแต่งเส้นประกอบซึ่งจะใส่สีเส้นประกอบที่เหลือตามความเร็วที่อ่านได้ ระบุฟังก์ชันนี้เป็น FleetEngineTripLocationProviderOptions.remainingPolylineCustomization เพื่อแสดงผลเส้นประกอบที่รับรู้การจราจรของข้อมูลสำหรับเส้นประกอบที่เหลือ
tripId
ประเภท:  string
รหัสของการเดินทางที่ผู้ให้บริการสถานที่ตั้งรายนี้สังเกตเห็น ตั้งค่าช่องนี้เพื่อเริ่มการติดตาม
รับค่าเดิม: isPolling, pollingIntervalMillis
refresh
refresh()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  void
รีเฟรชตำแหน่งที่ติดตามอย่างชัดเจน
รับค่าเดิม: addListener
error
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่เกิดขึ้นเมื่อผู้ให้บริการตำแหน่งพบข้อผิดพลาด
update
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่เกิดขึ้นเมื่อคำขออัปเดตข้อมูล Fleet Engine เสร็จสิ้น
รับค่าเดิม: ispollingchange

อินเทอร์เฟซ FleetEngineTripLocationProviderOptions

อินเทอร์เฟซ google.maps.journeySharing.FleetEngineTripLocationProviderOptions

ตัวเลือกสำหรับผู้ให้บริการตำแหน่งการเดินทาง

authTokenFetcher
ประเภท:  AuthTokenFetcher
ระบุ JSON Web Token สำหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId
ประเภท:  string
รหัสโปรเจ็กต์ของผู้บริโภคจาก Google Cloud Console
activePolylineCustomization optional
ประเภท:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
ใช้การปรับแต่งกับโพลีไลน์ที่ใช้งานอยู่แล้ว เส้นประกอบที่ใช้งานอยู่จะสอดคล้องกับส่วนของเส้นทางที่รถกำลังขับผ่านอยู่

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น สีเส้นประกอบ) และการโต้ตอบ (เช่น การจัดการการคลิก)
  • หากระบุออบเจ็กต์ PolylineOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะถูกนำไปใช้กับเส้นประกอบหลังจากที่สร้างโพลีไลน์แล้ว โดยจะเขียนทับตัวเลือกเริ่มต้น หากมี
  • หากระบุฟังก์ชันไว้ จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างโพลีไลน์ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะเรียกทำงานเมื่อพิกัดของโพลีไลน์เปลี่ยนแปลง หรือเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine โดยไม่คำนึงว่าข้อมูลที่สอดคล้องกับเส้นประกอบนี้จะมีการเปลี่ยนแปลงหรือไม่

    ดูรายการพารามิเตอร์ที่จัดเตรียมไว้ให้และการใช้งานที่ TripPolylineCustomizationFunctionParams
destinationMarkerCustomization optional
ประเภท:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายปลายทางแล้ว

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripMarkerCustomizationFunctionParams
originMarkerCustomization optional
ประเภท:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
การปรับแต่งที่ใช้กับเครื่องหมายต้นทาง

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripMarkerCustomizationFunctionParams
pollingIntervalMillis optional
ประเภท:  number optional
เวลาขั้นต่ำระหว่างการดึงข้อมูลการอัปเดตตำแหน่งเป็นมิลลิวินาที หากการอัปเดตตำแหน่งใช้เวลานานกว่า pollingIntervalMillis การอัปเดตตำแหน่งครั้งต่อไปจะไม่เริ่มจนกว่าการอัปเดตปัจจุบันจะเสร็จสิ้น

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

ช่วงการหยั่งสัญญาณเริ่มต้นคือ 5, 000 มิลลิวินาที ซึ่งเป็นช่วงเวลาขั้นต่ำ หากคุณตั้งค่าช่วงการหยั่งสัญญาณให้ต่ำกว่าค่าที่ไม่ใช่ 0 ระบบจะใช้ 5000
remainingPolylineCustomization optional
ประเภท:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
การปรับแต่งมีผลกับเส้นประกอบที่เหลือ เส้นประกอบที่เหลือจะสอดคล้องกับส่วนหนึ่งของเส้นทางที่รถยังไม่ได้เริ่มวิ่งข้ามผ่าน

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น สีเส้นประกอบ) และการโต้ตอบ (เช่น การจัดการการคลิก)
  • หากระบุออบเจ็กต์ PolylineOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะถูกนำไปใช้กับเส้นประกอบหลังจากที่สร้างโพลีไลน์แล้ว โดยจะเขียนทับตัวเลือกเริ่มต้น หากมี
  • หากระบุฟังก์ชันไว้ จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างโพลีไลน์ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะเรียกทำงานเมื่อพิกัดของโพลีไลน์เปลี่ยนแปลง หรือเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine โดยไม่คำนึงว่าข้อมูลที่สอดคล้องกับเส้นประกอบนี้จะมีการเปลี่ยนแปลงหรือไม่

    ดูรายการพารามิเตอร์ที่จัดเตรียมไว้ให้และการใช้งานที่ TripPolylineCustomizationFunctionParams
takenPolylineCustomization optional
ประเภท:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
การปรับแต่งมีผลกับเส้นประกอบที่เลือก เส้นประกอบที่ตัดมาจากส่วนของเส้นทางที่รถวิ่งผ่านไปแล้ว

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น สีเส้นประกอบ) และการโต้ตอบ (เช่น การจัดการการคลิก)
  • หากระบุออบเจ็กต์ PolylineOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะถูกนำไปใช้กับเส้นประกอบหลังจากที่สร้างโพลีไลน์แล้ว โดยจะเขียนทับตัวเลือกเริ่มต้น หากมี
  • หากระบุฟังก์ชันไว้ จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างโพลีไลน์ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะเรียกทำงานเมื่อพิกัดของโพลีไลน์เปลี่ยนแปลง หรือเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine โดยไม่คำนึงว่าข้อมูลที่สอดคล้องกับเส้นประกอบนี้จะมีการเปลี่ยนแปลงหรือไม่

    ดูรายการพารามิเตอร์ที่จัดเตรียมไว้ให้และการใช้งานที่ TripPolylineCustomizationFunctionParams
tripId optional
ประเภท:  string optional
รหัสการเดินทางที่จะติดตามทันทีหลังจากที่มีการสร้างอินสแตนซ์ผู้ให้บริการตำแหน่ง หากไม่ระบุ ผู้ให้บริการตำแหน่งจะไม่เริ่มติดตามการเดินทาง ให้ใช้ FleetEngineTripLocationProvider.tripId เพื่อตั้งค่ารหัสและเริ่มติดตาม
vehicleMarkerCustomization optional
ประเภท:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายยานพาหนะ

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripMarkerCustomizationFunctionParams
waypointMarkerCustomization optional
ประเภท:  (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายชี้ทางแล้ว

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripWaypointMarkerCustomizationFunctionParams

อินเทอร์เฟซ FleetEngineTripLocationProviderUpdateEvent

อินเทอร์เฟซ google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

ออบเจ็กต์เหตุการณ์ที่ส่งไปยังเครื่องจัดการเหตุการณ์เมื่อมีการทริกเกอร์เหตุการณ์ FleetEngineTripLocationProvider.update

trip optional
ประเภท:  Trip optional
โครงสร้างการเดินทางที่แสดงผลโดยการอัปเดต ไม่สามารถแก้ไขได้