Trip and Order Progress

คลาส FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing");

ผู้ผลิต
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 optional เหตุการณ์ที่ทริกเกอร์เมื่อคำขออัปเดตข้อมูล Fleet Engine เสร็จสมบูรณ์
รับค่ามา: ispollingchange

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

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

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

พร็อพเพอร์ตี้
authTokenFetcher	ประเภท: AuthTokenFetcher ระบุ JSON Web Token สำหรับตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId	ประเภท: string รหัสโปรเจ็กต์ของผู้บริโภคจากคอนโซล Google Cloud
activePolylineCustomization ไม่บังคับ	ประเภท: (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional การปรับแต่งที่ใช้กับเส้นประกอบที่ใช้งานอยู่ เส้นประกอบที่ใช้งานอยู่จะสอดคล้องกับส่วนของเส้นทางที่ยานพาหนะกำลังเคลื่อนผ่าน ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น สีของเส้นประกอบ) และการโต้ตอบ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ PolylineOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเส้นประกอบหลังจากสร้างเส้นประกอบแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเส้นประกอบ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อพิกัดของเส้นประกอบเปลี่ยนแปลง หรือเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเส้นประกอบนี้จะเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripPolylineCustomizationFunctionParams
destinationMarkerCustomization ไม่บังคับ	ประเภท: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional การปรับแต่งที่ใช้กับเครื่องหมายปลายทาง ใช้ช่องนี้เพื่อระบุรูปแบบที่กำหนดเอง (เช่น ไอคอนตัวทำเครื่องหมาย) และการมีปฏิสัมพันธ์ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเครื่องหมายหลังจากสร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มลงในมุมมองแผนที่ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripMarkerCustomizationFunctionParams
originMarkerCustomization ไม่บังคับ	ประเภท: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional การปรับแต่งที่ใช้กับเครื่องหมายต้นทาง ใช้ช่องนี้เพื่อระบุรูปแบบที่กำหนดเอง (เช่น ไอคอนตัวทำเครื่องหมาย) และการมีปฏิสัมพันธ์ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเครื่องหมายหลังจากสร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มลงในมุมมองแผนที่ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripMarkerCustomizationFunctionParams
pollingIntervalMillis ไม่บังคับ	ประเภท: number optional ระยะเวลาขั้นต่ำระหว่างการดึงข้อมูลการอัปเดตตำแหน่งเป็นมิลลิวินาที หากใช้เวลานานกว่า pollingIntervalMillis ในการดึงข้อมูลอัปเดตตำแหน่ง การอัปเดตตำแหน่งครั้งถัดไปจะไม่เริ่มจนกว่าการอัปเดตปัจจุบันจะเสร็จสิ้น การตั้งค่านี้เป็น 0 จะปิดใช้การอัปเดตตำแหน่งที่เกิดซ้ำ ระบบจะดึงข้อมูลการอัปเดตตำแหน่งใหม่หากพารามิเตอร์ที่ผู้ให้บริการตำแหน่งสังเกตเห็นมีการเปลี่ยนแปลง ช่วงเวลาการสำรวจเริ่มต้นคือ 5, 000 มิลลิวินาที ซึ่งเป็นช่วงเวลาขั้นต่ำ หากคุณตั้งค่าช่วงเวลาการตรวจสอบเป็นค่าที่ไม่ใช่ 0 ที่ต่ำกว่า ระบบจะใช้ 5000
remainingPolylineCustomization ไม่บังคับ	ประเภท: (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional การปรับแต่งที่ใช้กับเส้นประกอบที่เหลือ เส้นประกอบที่เหลือจะสอดคล้องกับส่วนของเส้นทางที่ยานพาหนะยังไม่ได้เริ่มเดินทางผ่าน ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น สีของเส้นประกอบ) และการโต้ตอบ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ PolylineOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเส้นประกอบหลังจากสร้างเส้นประกอบแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเส้นประกอบ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อพิกัดของเส้นประกอบเปลี่ยนแปลง หรือเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเส้นประกอบนี้จะเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripPolylineCustomizationFunctionParams
takenPolylineCustomization ไม่บังคับ	ประเภท: (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional การปรับแต่งที่ใช้กับเส้นประกอบที่ถ่ายไว้ เส้นประกอบที่ใช้จะสอดคล้องกับส่วนของเส้นทางที่ยานพาหนะได้เดินทางผ่านไปแล้ว ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น สีของเส้นประกอบ) และการโต้ตอบ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ PolylineOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเส้นประกอบหลังจากสร้างเส้นประกอบแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเส้นประกอบ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อพิกัดของเส้นประกอบเปลี่ยนแปลง หรือเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเส้นประกอบนี้จะเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripPolylineCustomizationFunctionParams
tripId ไม่บังคับ	ประเภท: string optional รหัสการเดินทางที่จะติดตามทันทีหลังจากสร้างอินสแตนซ์ผู้ให้บริการตำแหน่ง หากไม่ได้ระบุ ผู้ให้บริการตำแหน่งจะไม่เริ่มติดตามการเดินทางใดๆ ให้ใช้ FleetEngineTripLocationProvider.tripId เพื่อตั้งค่ารหัสและเริ่มการติดตาม
vehicleMarkerCustomization ไม่บังคับ	ประเภท: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional การปรับแต่งที่ใช้กับเครื่องหมายยานพาหนะ ใช้ช่องนี้เพื่อระบุรูปแบบที่กำหนดเอง (เช่น ไอคอนตัวทำเครื่องหมาย) และการมีปฏิสัมพันธ์ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเครื่องหมายหลังจากสร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มลงในมุมมองแผนที่ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripMarkerCustomizationFunctionParams
waypointMarkerCustomization ไม่บังคับ	ประเภท: (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional การปรับแต่งที่ใช้กับเครื่องหมายจุดอ้างอิง ใช้ช่องนี้เพื่อระบุรูปแบบที่กำหนดเอง (เช่น ไอคอนตัวทำเครื่องหมาย) และการมีปฏิสัมพันธ์ (เช่น การจัดการการคลิก) หากมีการระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์จะนำไปใช้กับเครื่องหมายหลังจากสร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นหากมี หากมีการระบุฟังก์ชัน ระบบจะเรียกใช้ฟังก์ชันดังกล่าว 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มลงในมุมมองแผนที่ (ในการเรียกใช้นี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ฟังก์ชันจะตั้งค่าเป็น true) นอกจากนี้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม ดูรายการพารามิเตอร์ที่ระบุและการใช้งานได้ที่ TripWaypointMarkerCustomizationFunctionParams

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

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

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

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