Shipment Tracking

คลาส FleetEngineShipmentLocationProvider

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

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

ชั้นเรียนนี้ขยายระยะเวลาถึง PollingLocationProvider

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

FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
พารามิเตอร์: 
สร้างผู้ให้บริการตำแหน่งใหม่เพื่อติดตามการจัดส่งของ Fleet Engine
trackingId
ประเภท:  string
รหัสติดตามงานที่ผู้ให้บริการตำแหน่งนี้สังเกตเห็น ตั้งค่าช่องนี้เพื่อเริ่มการติดตาม
รับค่าเดิม: isPolling, pollingIntervalMillis
refresh
refresh()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  void
รีเฟรชตำแหน่งที่ติดตามอย่างชัดเจน
รับค่าเดิม: addListener
error
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่เกิดขึ้นเมื่อผู้ให้บริการตำแหน่งพบข้อผิดพลาด
update
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่เกิดขึ้นเมื่อคำขออัปเดตข้อมูล Fleet Engine เสร็จสิ้น
รับค่าเดิม: ispollingchange

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

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

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

authTokenFetcher
ประเภท:  AuthTokenFetcher
ระบุ JSON Web Token สำหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ 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, อนันต์ หรือค่าลบจะปิดใช้การอัปเดตตำแหน่งอัตโนมัติ ระบบจะดึงข้อมูลการอัปเดตตำแหน่งใหม่ 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

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

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

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