Fleet Tracking - On Demand Rides & Delivery (beta)

FleetEngineVehicleLocationProvider คลาส

google.maps.journeySharing.FleetEngineVehicleLocationProvider ชั้น

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

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

เข้าถึงโดยโทรไปที่ const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

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

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

ช่วงเวลาการหยั่งสัญญาณเริ่มต้นคือ 5, 000 มิลลิวินาที ซึ่งเป็นช่วงเวลาต่ําสุด หากคุณตั้งค่าช่วงการสํารวจเป็นค่าที่ไม่ใช่ศูนย์ ค่าจะถูกใช้ 5, 000
staleLocationThresholdMillis optional
ประเภท:  number optional
เกณฑ์สําหรับตําแหน่งของรถเก่า หากตําแหน่งอัปเดตล่าสุดของรถคันนี้เก่าเกินกว่าเกณฑ์นี้ รถก็จะไม่แสดง ค่าเริ่มต้นคือ 24 ชั่วโมงเป็นมิลลิวินาที หากเกณฑ์ต่ํากว่า 0 หรือ Infinity ระบบจะไม่สนใจเกณฑ์และไม่ถือว่าตําแหน่งของรถเก่า
vehicleId optional
ประเภท:  string optional
ใช้รหัสยานพาหนะที่จะติดตามทันทีหลังจากที่ระบุตําแหน่งของผู้ให้บริการ หากไม่ระบุ ผู้ให้บริการตําแหน่งจะเริ่มไม่ติดตามรถ ใช้ FleetEngineVehicleLocationProvider.vehicleId เพื่อตั้งค่ารหัสและเริ่มติดตาม
vehicleMarkerCustomization optional
ประเภท:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ใช้การปรับแต่งกับยานพาหนะแล้ว

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

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

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

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

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

trips optional
ประเภท:  Array<Trip> optional
ข้อมูลการเดินทางที่ดําเนินการโดยรถยนต์คันนี้ ไม่สามารถแก้ไขได้
vehicle optional
ประเภท:  Vehicle optional
โครงสร้างข้อมูลยานพาหนะกลับมาโดยการอัปเดต ไม่สามารถแก้ไขได้

FleetEngineFleetLocationProvider คลาส

google.maps.journeySharing.FleetEngineFleetLocationProvider ชั้น

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

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

เข้าถึงโดยโทรไปที่ const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API

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

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

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

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

authTokenFetcher
ประเภท:  AuthTokenFetcher
มีโทเค็นเว็บ JSON สําหรับการตรวจสอบสิทธิ์ไคลเอ็นต์กับ Fleet Engine
projectId
ประเภท:  string
รหัสโปรเจ็กต์ของผู้บริโภคจาก Google Cloud Console
locationRestriction optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ละติจูด/ลองจิจูดจะอยู่ภายในขอบเขตเพื่อติดตามยานพาหนะทันทีหลังจากที่ระบุตําแหน่งของผู้ให้บริการ หากไม่ได้ตั้งค่า ผู้ให้บริการตําแหน่งจะไม่เริ่มติดตามยานพาหนะ ใช้ FleetEngineFleetLocationProvider.locationRestriction เพื่อกําหนดขอบเขตและเริ่มติดตาม หากต้องการติดตามยานพาหนะทั้งหมดโดยไม่คํานึงถึงตําแหน่ง ให้ตั้งค่าขอบเขตที่เทียบเท่ากับพื้นโลก
staleLocationThresholdMillis optional
ประเภท:  number optional
เกณฑ์สําหรับตําแหน่งของรถเก่า หากตําแหน่งอัปเดตล่าสุดสําหรับยานพาหนะเก่ากว่าเกณฑ์นี้ รถจะไม่แสดง ค่าเริ่มต้นคือ 24 ชั่วโมงเป็นมิลลิวินาที หากเกณฑ์ต่ํากว่า 0 หรือ Infinity ระบบจะไม่สนใจเกณฑ์ดังกล่าวและไม่ถือว่าตําแหน่งเก่า
vehicleFilter optional
ประเภท:  string optional
การค้นหาตัวกรองที่จะใช้เมื่อดึงข้อมูลรถยนต์ ตัวกรองนี้จะส่งต่อไปยัง Fleet Engine โดยตรง

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

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

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

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

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

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

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

vehicles optional
ประเภท:  Array<Vehicle> optional
รายการยานพาหนะที่แสดงผลตามการค้นหา ไม่สามารถแก้ไขได้