Shipment Tracking

คลาส FleetEngineShipmentLocationProvider

class google.maps.journeySharing.FleetEngineShipmentLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

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

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

ผู้ผลิต
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

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

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

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

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

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

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

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