Trip and Order Progress

คลาส FleetEngineTripLocationProvider

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

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

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

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

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

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

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

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

authTokenFetcher
ประเภท:  AuthTokenFetcher
ระบุ JSON Web Token สำหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId
ประเภท:  string
รหัสโปรเจ็กต์ของผู้บริโภคจาก Google Cloud Console
destinationMarkerCustomization optional
ประเภท:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายปลายทางแล้ว

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripMarkerCustomizationFunctionParams
originMarkerCustomization optional
ประเภท:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
การปรับแต่งที่ใช้กับเครื่องหมายต้นทาง

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripMarkerCustomizationFunctionParams
pollingIntervalMillis optional
ประเภท:  number optional
เวลาขั้นต่ำระหว่างการดึงข้อมูลการอัปเดตตำแหน่งเป็นมิลลิวินาที หากการอัปเดตตำแหน่งใช้เวลานานกว่า pollingIntervalMillis การอัปเดตตำแหน่งครั้งต่อไปจะไม่เริ่มจนกว่าการอัปเดตปัจจุบันจะเสร็จสิ้น

การตั้งค่านี้เป็น 0 จะปิดใช้การอัปเดตตำแหน่งที่เกิดซ้ำ ระบบจะดึงข้อมูลการอัปเดตตำแหน่งใหม่หากพารามิเตอร์ที่ผู้ให้บริการตำแหน่งสังเกตพบมีการเปลี่ยนแปลง

ช่วงการหยั่งสัญญาณเริ่มต้นคือ 5, 000 มิลลิวินาที ซึ่งเป็นช่วงเวลาขั้นต่ำ หากคุณตั้งค่าช่วงการหยั่งสัญญาณให้ต่ำกว่าค่าที่ไม่ใช่ 0 ระบบจะใช้ 5000
tripId optional
ประเภท:  string optional
รหัสการเดินทางที่จะติดตามทันทีหลังจากที่มีการสร้างอินสแตนซ์ผู้ให้บริการตำแหน่ง หากไม่ระบุ ผู้ให้บริการตำแหน่งจะไม่เริ่มติดตามการเดินทาง ให้ใช้ FleetEngineTripLocationProvider.tripId เพื่อตั้งค่ารหัสและเริ่มติดตาม
vehicleMarkerCustomization optional
ประเภท:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายยานพาหนะ

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripMarkerCustomizationFunctionParams
waypointMarkerCustomization optional
ประเภท:  (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายชี้ทางแล้ว

ใช้ช่องนี้เพื่อระบุการจัดรูปแบบที่กำหนดเอง (เช่น ไอคอนเครื่องหมาย) และการโต้ตอบ (เช่น การจัดการคลิก)
  • หากระบุออบเจ็กต์ MarkerOptions การเปลี่ยนแปลงที่ระบุในออบเจ็กต์ดังกล่าวจะถูกนำไปใช้กับเครื่องหมายหลังจากที่สร้างเครื่องหมายแล้ว โดยจะเขียนทับตัวเลือกเริ่มต้นของตัวเลือก หากมี
  • ถ้าระบุฟังก์ชันแล้ว จะมีการเรียกใช้ 1 ครั้งเมื่อสร้างเครื่องหมาย ก่อนที่จะเพิ่มในมุมมองแผนที่ (ในการเรียกนี้ พารามิเตอร์ isNew ในออบเจ็กต์พารามิเตอร์ของฟังก์ชันจะตั้งค่าไว้เป็น true) นอกจากนี้ ฟังก์ชันนี้จะทำงานเมื่อผู้ให้บริการตำแหน่งได้รับข้อมูลจาก Fleet Engine ไม่ว่าข้อมูลที่สอดคล้องกับเครื่องหมายนี้จะมีการเปลี่ยนแปลงหรือไม่ก็ตาม

    ดูรายการพารามิเตอร์ที่มีให้และการใช้งานที่ TripWaypointMarkerCustomizationFunctionParams

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

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

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

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