Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider คลาส

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider คลาส

ผู้ให้บริการตําแหน่งที่นําส่งยานพาหนะ

คลาสนี้จะขยาย PollingLocationProvider

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

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
พารามิเตอร์: 
สร้างผู้ให้บริการตําแหน่งใหม่สําหรับยานพาหนะที่ใช้ Fleet Engine
deliveryVehicleId
ประเภท:  string
รหัสของยานพาหนะที่ผู้ให้บริการตําแหน่งนี้สังเกตการณ์ ตั้งค่าช่องนี้เพื่อติดตามยานพาหนะ
shouldShowOutcomeLocations
ประเภท:  boolean optional
(ไม่บังคับ) อนุญาตให้ผู้ใช้แสดงสถานที่ตั้งของผลลัพธ์ของงาน
shouldShowTasks
ประเภท:  boolean optional
เลือกอนุญาตให้ผู้ใช้แสดงงานที่ดึงมา
staleLocationThresholdMillis
ประเภท:  number
ช่องนี้เป็นแบบอ่านอย่างเดียว เกณฑ์สําหรับตําแหน่งของรถที่ไม่มีอัปเดต หากตําแหน่งอัปเดตล่าสุดสําหรับยานพาหนะที่เก่ากว่าเกณฑ์นี้ ยานพาหนะจะไม่แสดง
taskFilterOptions
ประเภท:  FleetEngineTaskFilterOptions
แสดงผลตัวเลือกตัวกรองที่จะมีผลเมื่อดึงงาน
รับค่ามา: isPolling, pollingIntervalMillis
รับค่ามา: addListener
error
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่เกิดขึ้นเมื่อผู้ให้บริการตําแหน่งพบข้อผิดพลาด
update
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่ทริกเกอร์เมื่อคําขออัปเดตข้อมูล Fleet Engine เสร็จสิ้น
รับค่ามา: ispollingchange

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

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

ตัวเลือกสําหรับผู้ให้บริการขนส่งยานพาหนะ

authTokenFetcher
ประเภท:  AuthTokenFetcher
มีโทเค็นเว็บ JSON สําหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId
ประเภท:  string
รหัสโปรเจ็กต์ของผู้บริโภคจาก Google Cloud Console
deliveryVehicleId optional
ประเภท:  string optional
รหัสยานพาหนะที่นําส่งให้คุณติดตามทันทีที่ผู้ให้บริการตําแหน่งได้รับสร้างอินสแตนซ์ หากไม่ได้ระบุไว้ ผู้ให้บริการตําแหน่งจะไม่เริ่มติดตามยานพาหนะ ให้ใช้ FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId เพื่อตั้งค่ารหัสและเริ่มติดตาม
deliveryVehicleMarkerCustomization optional
ประเภท:  (function(DeliveryVehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายจราจรของยานพาหนะแล้ว

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

    โปรดดู DeliveryVehicleMarkerCustomizationFunctionParams สําหรับรายการพารามิเตอร์ที่มีให้และการใช้งาน
plannedStopMarkerCustomization optional
ประเภท:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับเครื่องหมายหยุดที่วางแผนไว้

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

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

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

ช่วงแบบสํารวจเริ่มต้นคือ 5, 000 มิลลิวินาที ซึ่งเป็นช่วงเวลาขั้นต่ํา หากตั้งค่าช่วงแบบสํารวจเป็นค่าที่ไม่ใช่ 0 จะมีการใช้ 5, 000
shouldShowOutcomeLocations optional
ประเภท:  boolean optional
บูลีนเพื่อแสดงหรือซ่อนตําแหน่งผลลัพธ์สําหรับงานที่ดึงมา
shouldShowTasks optional
ประเภท:  boolean optional
บูลีนเพื่อแสดงหรือซ่อนงาน การตั้งค่านี้เป็น false จะป้องกันไม่ให้ระบบเรียกปลายทาง ListTasks เพื่อดึงข้อมูลงาน ระบบจะแสดงเฉพาะป้ายหยุดรถที่กําลังจะเกิดขึ้นเท่านั้น
staleLocationThresholdMillis optional
ประเภท:  number optional
เกณฑ์สําหรับตําแหน่งของรถที่ไม่มีอัปเดต หากตําแหน่งของการอัปเดตครั้งล่าสุดของยานพาหนะเก่ากว่าเกณฑ์นี้ ยานพาหนะจะไม่แสดง ค่าเริ่มต้นคือ 24 ชั่วโมงเป็นมิลลิวินาที หากเกณฑ์ต่ํากว่า 0 หรือ Infinity ระบบจะไม่สนใจเกณฑ์ดังกล่าว และตําแหน่งสําหรับยานพาหนะจะไม่ถือว่าไม่มีอัปเดต
taskFilterOptions optional
ประเภท:  FleetEngineTaskFilterOptions optional
กรองตัวเลือกที่จะใช้เมื่อดึงงาน ตัวเลือกอาจประกอบด้วยยานพาหนะ เวลา และสถานะงานที่เฉพาะเจาะจง
taskMarkerCustomization optional
ประเภท:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับตัวทําเครื่องหมายงานแล้ว ตัวทําเครื่องหมายงานจะแสดงผลในตําแหน่งที่วางแผนของงานแต่ละรายการที่กําหนดให้กับยานพาหนะที่นําส่ง

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

    โปรดดู TaskMarkerCustomizationFunctionParams สําหรับรายการพารามิเตอร์ที่มีให้และการใช้งาน
taskOutcomeMarkerCustomization optional
ประเภท:  function(TaskMarkerCustomizationFunctionParams): void optional
ใช้การปรับแต่งกับตัวทําเครื่องหมายผลลัพธ์ของงานแล้ว ตัวทําเครื่องหมายผลลัพธ์งานจะแสดงผลที่ตําแหน่งผลการค้นหาจริงของแต่ละงานที่กําหนดให้กับยานพาหนะการนําส่ง

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

    โปรดดู TaskMarkerCustomizationFunctionParams สําหรับรายการพารามิเตอร์ที่มีให้และการใช้งาน

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

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

ตัวเลือกการกรองงานในผู้ให้บริการยานพาหนะที่นําส่ง

completionTimeFrom optional
ประเภท:  Date optional
ขอบเขตล่างพิเศษสําหรับเวลาที่งานเสร็จ ใช้สําหรับกรองงานที่ทําเสร็จหลังเวลาที่ระบุ
completionTimeTo optional
ประเภท:  Date optional
ขอบเขตบนของเวลาที่แน่นอนในการทํางานให้เสร็จสมบูรณ์ ใช้สําหรับกรองงานที่ทําเสร็จก่อนเวลาที่ระบุ
state optional
ประเภท:  string optional
สถานะของงาน ค่าที่ถูกต้องคือ "เปิด" หรือ "ปิด"

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

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

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

completedVehicleJourneySegments optional
ประเภท:  Array<VehicleJourneySegment> optional
ส่วนของเส้นทางที่ใช้ยานพาหนะนี้เสร็จสมบูรณ์แล้ว แก้ไขไม่ได้
deliveryVehicle optional
ประเภท:  DeliveryVehicle optional
การอัปเดตโครงสร้างข้อมูลยานพาหนะนําส่งแล้ว แก้ไขไม่ได้
tasks optional
ประเภท:  Array<Task> optional
รายการงานที่ให้บริการโดยยานพาหนะส่งสินค้านี้ แก้ไขไม่ได้

FleetEngineDeliveryFleetLocationProvider คลาส

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider คลาส

ผู้ให้บริการตําแหน่งการนําส่ง

คลาสนี้จะขยาย PollingLocationProvider

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

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
พารามิเตอร์: 
สร้างผู้ให้บริการตําแหน่งใหม่สําหรับยานพาหนะที่ Fleet Engine ติดตาม
deliveryVehicleFilter
ประเภท:  string optional
ตัวกรองที่ใช้เมื่อดึงข้อมูลยานพาหนะที่นําส่ง
locationRestriction
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสําหรับติดตามยานพาหนะสําหรับการนําส่ง หากไม่มีการกําหนดขอบเขต ก็จะไม่มีการติดตามยานพาหนะที่นําส่งสินค้า หากต้องการติดตามยานพาหนะสําหรับการนําส่งทั้งหมดโดยไม่คํานึงถึงขอบเขต ให้กําหนดขอบเขตที่เทียบเท่ากับโลก
staleLocationThresholdMillis
ประเภท:  number
ช่องนี้เป็นแบบอ่านอย่างเดียว เกณฑ์สําหรับตําแหน่งของรถที่ไม่มีอัปเดต หากตําแหน่งอัปเดตล่าสุดสําหรับยานพาหนะที่เก่ากว่าเกณฑ์นี้ ยานพาหนะจะไม่แสดง
รับค่ามา: isPolling, pollingIntervalMillis
รับค่ามา: addListener
update
function(event)
อาร์กิวเมนต์: 
เหตุการณ์ที่ทริกเกอร์เมื่อคําขออัปเดตข้อมูล Fleet Engine เสร็จสิ้น
รับค่ามา: ispollingchange

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

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

ตัวเลือกสําหรับผู้ให้บริการตําแหน่งยานพาหนะ

authTokenFetcher
ประเภท:  AuthTokenFetcher
มีโทเค็นเว็บ JSON สําหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId
ประเภท:  string
รหัสโปรเจ็กต์ของผู้บริโภคจาก Google Cloud Console
deliveryVehicleFilter optional
ประเภท:  string optional
การค้นหาตัวกรองที่จะใช้เมื่อดึงข้อมูลยานพาหนะที่นําส่ง ตัวกรองนี้จะส่งผ่านไปยัง Fleet Engine โดยตรง

ดูรูปแบบที่รองรับได้ที่ ListDeliveryVehiclesRequest.filter

โปรดทราบว่าตัวกรองที่ถูกต้องสําหรับแอตทริบิวต์ต้องมีคํานําหน้า "attributes" เช่น attributes.x = "y" หรือ attributes."x y" = "z"
deliveryVehicleMarkerCustomization optional
ประเภท:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
ใช้การปรับแต่งกับเครื่องหมายจราจรของยานพาหนะแล้ว

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

    โปรดดู DeliveryVehicleMarkerCustomizationFunctionParams สําหรับรายการพารามิเตอร์ที่มีให้และการใช้งาน
locationRestriction optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ละติจูด/ลองจิจูดที่ล้อมรอบสําหรับการติดตามยานพาหนะทันทีหลังจากที่สร้างอินสแตนซ์ตําแหน่ง หากไม่ได้ตั้งค่า ผู้ให้บริการตําแหน่งจะไม่เริ่มติดตามยานพาหนะ ให้ใช้ FleetEngineDeliveryFleetLocationProvider.locationRestriction เพื่อกําหนดขอบเขตและเริ่มติดตาม หากต้องการติดตามยานพาหนะสําหรับการนําส่งทั้งหมดโดยไม่คํานึงถึงขอบเขต ให้กําหนดขอบเขตที่เทียบเท่ากับโลก
staleLocationThresholdMillis optional
ประเภท:  number optional
เกณฑ์สําหรับตําแหน่งของรถที่ไม่มีอัปเดต หากตําแหน่งของการอัปเดตครั้งล่าสุดของยานพาหนะเก่ากว่าเกณฑ์นี้ ยานพาหนะจะไม่แสดง ค่าเริ่มต้นคือ 24 ชั่วโมงเป็นมิลลิวินาที หากเกณฑ์ต่ํากว่า 0 หรือ Infinity ระบบจะไม่สนใจเกณฑ์ดังกล่าว และตําแหน่งสําหรับยานพาหนะจะไม่ถือว่าไม่มีอัปเดต

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

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

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

deliveryVehicles optional
ประเภท:  Array<DeliveryVehicle> optional
รายการยานพาหนะนําส่งตามคําค้นหา แก้ไขไม่ได้