Trip and Order Progress

FleetEngineTripLocationProvider class

google.maps.journeySharing.FleetEngineTripLocationProvider class

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

คลาสนี้ขยายจาก PollingLocationProvider

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

ผู้ผลิต
FleetEngineTripLocationProvider	FleetEngineTripLocationProvider(options) พารามิเตอร์:  options:  FleetEngineTripLocationProviderOptions ตัวเลือกสําหรับผู้ให้บริการตําแหน่ง สร้างผู้ให้บริการตำแหน่งใหม่สำหรับการเดินทางของ Fleet Engine

เมธอดแบบคงที่
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params) พารามิเตอร์:  params:  TripPolylineCustomizationFunctionParams พารามิเตอร์ที่ระบุให้กับฟังก์ชันการปรับแต่งเส้นประกอบ ผลลัพธ์: ไม่มี ฟังก์ชันการปรับแต่งเส้นประกอบที่จะเปลี่ยนสีเส้นประกอบที่ใช้งานอยู่ตามการอ่านความเร็ว ระบุฟังก์ชันนี้เป็น FleetEngineTripLocationProviderOptions.activePolylineCustomization เพื่อแสดงผลโพลีไลน์ที่คำนึงถึงสภาพการจราจรสำหรับโพลีไลน์ที่ใช้งานอยู่
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params) พารามิเตอร์:  params:  TripPolylineCustomizationFunctionParams พารามิเตอร์ที่ระบุให้กับฟังก์ชันการปรับแต่งเส้นประกอบ ผลลัพธ์: ไม่มี ฟังก์ชันการปรับแต่งเส้นประกอบที่จะระบายสีเส้นประกอบที่เหลือตามการอ่านความเร็ว ระบุฟังก์ชันนี้เป็น FleetEngineTripLocationProviderOptions.remainingPolylineCustomization เพื่อแสดงผลรูปหลายเหลี่ยมที่คำนึงถึงสภาพการจราจรสำหรับรูปหลายเหลี่ยมที่เหลือ

พร็อพเพอร์ตี้
tripId	ประเภท:  string รหัสของการเดินทางที่ผู้ให้บริการตำแหน่งนี้สังเกตเห็น ตั้งค่าช่องนี้เพื่อเริ่มการติดตาม
รับค่ามา: isPolling, pollingIntervalMillis

เมธอด
refresh	refresh() พารามิเตอร์: ไม่มี ผลลัพธ์:  void รีเฟรชตำแหน่งที่ติดตามอย่างชัดเจน
รับค่า: addListener

กิจกรรม
error	function(event) อาร์กิวเมนต์:  event:  ErrorEvent เหตุการณ์ที่ทริกเกอร์เมื่อผู้ให้บริการตำแหน่งพบข้อผิดพลาด
update	function(event) อาร์กิวเมนต์:  event:  FleetEngineTripLocationProviderUpdateEvent เหตุการณ์ที่ทริกเกอร์เมื่อคําขออัปเดตข้อมูลของ Fleet Engine เสร็จสมบูรณ์
รับค่า: ispollingchange

FleetEngineTripLocationProviderOptions interface

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

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

พร็อพเพอร์ตี้
authTokenFetcher	ประเภท:  AuthTokenFetcher ให้ JSON Web Token เพื่อตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId	ประเภท:  string รหัสโปรเจ็กต์ของผู้บริโภคจากคอนโซล Google Cloud
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 interface

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

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

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