Shipment Tracking

FleetEngineShipmentLocationProvider class

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

ผู้ให้บริการตำแหน่งการจัดส่ง

ชั้นเรียนนี้ขยายเวลา PollingLocationProvider

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

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

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

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

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

FleetEngineShipmentLocationProviderOptions interface

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

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

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

FleetEngineShipmentLocationProviderUpdateEvent interface

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

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

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