Shipment Tracking

FleetEngineShipmentLocationProvider class

google.maps.journeySharing.FleetEngineShipmentLocationProvider class

ผู้ให้บริการสถานที่จัดส่ง

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