Trip and Order Progress

FleetEngineTripLocationProvider class

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 สำหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ 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 มิลลิวินาที ซึ่งเป็นช่วงเวลาขั้นต่ำ หากคุณตั้งค่าช่วงเวลาการสำรวจเป็นค่าที่ไม่ใช่ศูนย์ที่ต่ำกว่า ระบบจะใช้ค่า 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
โครงสร้างการเดินทางที่การอัปเดตแสดงผล แก้ไขไม่ได้