Fleet Engine Entities

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

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

รายละเอียดของงานที่ Fleet Engine ส่งคืน
attributes
ประเภท:  Object<string, *>
แอตทริบิวต์ที่มอบหมายให้กับงาน
name
ประเภท:  string
ชื่องานในรูปแบบ "providers/{provider_id}/tasks/{task_id}" Tasks รหัสงานต้องเป็นตัวระบุที่ไม่ซ้ํากัน ไม่ใช่รหัสติดตาม หากต้องการจัดเก็บรหัสติดตามของการจัดส่ง ให้ใช้ช่อง tracking_id งานหลายรายการมี tracking_id เดียวกัน
remainingVehicleJourneySegments
ประเภท:  Array<VehicleJourneySegment>
ข้อมูลเกี่ยวกับกลุ่มที่เหลือเพื่อดําเนินการให้เสร็จสมบูรณ์สําหรับงานนี้
status
ประเภท:  string
สถานะการดําเนินการปัจจุบันของงาน
type
ประเภท:  string
ประเภทงาน เช่น ช่วงพักหรือการจัดส่ง
estimatedCompletionTime optional
ประเภท:  Date optional
การประทับเวลาของงานที่เสร็จสมบูรณ์โดยประมาณ
latestVehicleLocationUpdate optional
ประเภท:  VehicleLocationUpdate optional
ข้อมูลเฉพาะเกี่ยวกับการอัปเดตตําแหน่งล่าสุด
outcome optional
ประเภท:  string optional
ผลลัพธ์ของงาน
outcomeLocation optional
ประเภท:  LatLngLiteral optional
ตําแหน่งที่งานเสร็จสมบูรณ์ (จากผู้ให้บริการ)
outcomeLocationSource optional
ประเภท:  string optional
ตําแหน่งที่ตั้งของผลลัพธ์งาน ('PROVIDER' หรือ 'LAST_VEHICLE_LOCATION')
outcomeTime optional
ประเภท:  Date optional
การประทับเวลาที่ตั้งค่าผลลัพธ์ของงาน (จากผู้ให้บริการ)
plannedLocation optional
ประเภท:  LatLngLiteral optional
ตําแหน่งที่จะทํางานให้เสร็จ
targetTimeWindow optional
ประเภท:  TimeWindow optional
กรอบเวลาที่งานควรจะเสร็จ
trackingId optional
ประเภท:  string optional
รหัสติดตามของการจัดส่ง
vehicleId optional
ประเภท:  string optional
รหัสของยานพาหนะที่ดําเนินงานนี้

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

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

ประเภท TaskInfo ใช้งานโดย DeliveryVehicleStop
extraDurationMillis optional
ประเภท:  number optional
เวลาเพิ่มเติมในการทํางานเป็นมิลลิวินาที
id optional
ประเภท:  string optional
รหัสของงาน
targetTimeWindow optional
ประเภท:  TimeWindow optional
กรอบเวลาที่งานควรจะเสร็จ

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

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

รายละเอียดของออบเจ็กต์ข้อมูลการติดตามงานที่แสดงผลโดย Fleet Engine
attributes
ประเภท:  Object<string, *>
แอตทริบิวต์ที่มอบหมายให้กับงาน
name
ประเภท:  string
ชื่อในรูปแบบ "providers/{provider_id}/taskTrackingInfo/{tracking_id}" ซึ่ง tracking_id แสดงรหัสติดตาม
trackingId
ประเภท:  string
รหัสติดตามของงาน
  • ต้องเป็นสตริง Unicode ที่ถูกต้อง
  • จํากัดความยาวสูงสุด 64 อักขระ
  • ทําข้อมูลให้เป็นมาตรฐานแล้วตามแบบฟอร์มการปรับมาตรฐานของ Unicode C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: "/", ":", "?", "," หรือ "#"
estimatedArrivalTime optional
ประเภท:  Date optional
เวลาถึงโดยประมาณที่จะถึงจุดแวะ
estimatedTaskCompletionTime optional
ประเภท:  Date optional
เวลาที่เสร็จสมบูรณ์ของงานโดยประมาณ
latestVehicleLocationUpdate optional
ประเภท:  VehicleLocationUpdate optional
ข้อมูลเฉพาะเกี่ยวกับการอัปเดตตําแหน่งล่าสุด
plannedLocation optional
ประเภท:  LatLng optional
ตําแหน่งที่จะทํางานให้เสร็จสิ้น
remainingDrivingDistanceMeters optional
ประเภท:  number optional
ระยะทางรวมเป็นเมตรกับ VehicleStop ที่สนใจ
remainingStopCount optional
ประเภท:  number optional
ระบุจํานวนป้ายหยุดรถที่เหลืออยู่จนกระทั่งถึงจุดหยุดงาน รวมถึงป้ายหยุดงาน เช่น หากจุดแวะถัดไปของยานพาหนะคือการหยุดงาน ค่าจะเป็น 1
routePolylinePoints optional
ประเภท:  Array<LatLng> optional
รายการจุดที่เชื่อมต่อเมื่อมีเส้นประกอบของเส้นทางที่คาดไว้ของยานพาหนะไปยังตําแหน่งของงานนี้
state optional
ประเภท:  string optional
สถานะการดําเนินการปัจจุบันของงาน
targetTimeWindow optional
ประเภท:  TimeWindow optional
กรอบเวลาที่งานควรจะเสร็จ
taskOutcome optional
ประเภท:  string optional
ผลลัพธ์ของการพยายามเรียกใช้งาน
taskOutcomeTime optional
ประเภท:  Date optional
เวลาที่ผู้ให้บริการตั้งค่าผลลัพธ์ของงาน

การเดินทาง

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

รายละเอียดสําหรับการเดินทางที่ Fleet Engine แสดงผล
name
ประเภท:  string
ในรูปแบบ "providers/{provider_id}/trips/{trip_id}" Tripid ต้องเป็นตัวระบุที่ไม่ซ้ํากัน
passengerCount
ประเภท:  number
จํานวนผู้โดยสารในการเดินทางนี้ ไม่รวมคนขับ
remainingWaypoints
ประเภท:  Array<VehicleWaypoint>
อาร์เรย์ของจุดอ้างอิงที่ระบุเส้นทางจากตําแหน่งปัจจุบันไปยังจุดส่ง
status
ประเภท:  string
สถานะปัจจุบันของการเดินทาง ค่าที่เป็นไปได้คือ UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE หรือ CANCELED
type
ประเภท:  string
ประเภทของการเดินทาง ค่าที่เป็นไปได้คือ UNKNOWN_TRIP_TYPE, SHARED หรือ EXCLUSIVE
vehicleId
ประเภท:  string
รหัสยานพาหนะที่ทําการเดินทางนี้
actualDropOffLocation optional
ประเภท:  LatLngLiteral optional
สถานที่ที่ลูกค้าไม่อยู่
actualPickupLocation optional
ประเภท:  LatLngLiteral optional
สถานที่รับลูกค้า
dropOffTime optional
ประเภท:  Date optional
เวลาในอนาคตโดยประมาณที่ผู้โดยสารจะมาถึงหรือเวลาที่ลงจริงๆ
latestVehicleLocationUpdate optional
ประเภท:  VehicleLocationUpdate optional
ข้อมูลเฉพาะเกี่ยวกับการอัปเดตตําแหน่งล่าสุด
pickupTime optional
ประเภท:  Date optional
เวลาในอนาคตโดยประมาณที่จะไปรับผู้โดยสาร หรือเวลาจริงเวลาที่ไปรับ
plannedDropOffLocation optional
ประเภท:  LatLngLiteral optional
สถานที่ที่ลูกค้าระบุว่าจะออกไป
plannedPickupLocation optional
ประเภท:  LatLngLiteral optional
สถานที่ที่ลูกค้าระบุว่าจะไปรับ

อินเทอร์เฟซการแสดงโฆษณา

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

รายละเอียดของยานพาหนะที่นําส่งสินค้าซึ่งแสดงโดย Fleet Engine
attributes
ประเภท:  Object<string, string optional>
แอตทริบิวต์การจัดส่งที่กําหนดเอง
name
ประเภท:  string
ในรูปแบบ "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}" delivery_vehicle_id ต้องเป็นตัวระบุที่ไม่ซ้ํากัน
navigationStatus
ประเภท:  string
สถานะการนําทางปัจจุบันของยานพาหนะ
remainingDistanceMeters
ประเภท:  number
ระยะทางขับรถที่เหลืออยู่ในส่วนเส้นทางปัจจุบัน หน่วยเป็นเมตร
remainingVehicleJourneySegments
ประเภท:  Array<VehicleJourneySegment>
กลุ่มเส้นทางที่กําหนดให้กับยานพาหนะที่นําส่งนี้ โดยเริ่มจากตําแหน่งที่รายงานล่าสุดของยานพาหนะ จะมีการเติมค่าออบเจ็กต์ออบเจ็กต์ DeliveryVehicle ผ่านทาง FleetEngineDeliveryVehicleLocationProvider เท่านั้น
currentRouteSegmentEndPoint optional
ประเภท:  LatLngLiteral optional
ตําแหน่งที่ส่วนเส้นทางปัจจุบันสิ้นสุด
latestVehicleLocationUpdate optional
ประเภท:  VehicleLocationUpdate optional
ตําแหน่งที่รายงานล่าสุดของยานพาหนะที่นําส่ง
remainingDurationMillis optional
ประเภท:  number optional
ระยะเวลาการขับขี่ที่เหลือในส่วนเส้นทางปัจจุบันเป็นมิลลิวินาที

อินเทอร์เฟซของ DeliveryVehicleStop

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

ประเภทการนําส่งยานพาหนะ
tasks
ประเภท:  Array<TaskInfo>
รายการสิ่งที่ต้องทําที่จะดําเนินการในขั้นตอนนี้
  • id: รหัสของงาน
  • extraDurationMillis: เวลาเพิ่มเติมในการทํางานเป็นมิลลิวินาที
plannedLocation optional
ประเภท:  LatLngLiteral optional
ตําแหน่งของจุดแวะ
state optional
ประเภท:  DeliveryVehicleStopState optional
สถานะของการหยุด

VehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState ค่าคงที่

สถานะปัจจุบันของ DeliveryVehicleStop

เข้าถึงโดยโทรไปที่ const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API
ARRIVED มาถึงแล้วเมื่อมาถึง สมมติว่าพาหนะจอดในจุดแวะถัดไป เพื่อให้มั่นใจว่าจุดแวะก่อนหน้านี้ทั้งหมดจะเสร็จสมบูรณ์
ENROUTE กําหนดเส้นทางและใช้งานอยู่
NEW สร้างแล้ว แต่ไม่ได้กําหนดเส้นทาง
UNSPECIFIED ไม่รู้จัก

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

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

ประเภทยานพาหนะJourneyกลุ่ม
drivingDistanceMeters optional
ประเภท:  number optional
ระยะทางในการเดินทางจากจุดแวะพักก่อนหน้าเป็นจุดนี้ หน่วยเป็นเมตร
drivingDurationMillis optional
ประเภท:  number optional
เวลาในการเดินทางจากจุดแวะพักก่อนหน้าเป็นมิลลิวินาที
path optional
ประเภท:  Array<LatLngLiteral> optional
เส้นทางจากจุดแวะก่อนหน้า (หรือตําแหน่งปัจจุบันของรถคันนี้ หากการหยุดแวะนี้เป็นการหยุดแรกในรายการของป้ายจอดรถ)
stop optional
ประเภท:  DeliveryVehicleStop optional
ข้อมูลเกี่ยวกับจุดแวะพัก

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

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

ประเภทการอัปเดตตําแหน่งยานพาหนะ
heading optional
ประเภท:  number optional
ส่วนหัวของการอัปเดต 0 สอดคล้องกับทิศเหนือ 180 ถึงทิศใต้
location optional
ประเภท:  LatLngLiteral|LatLng optional
ตําแหน่งของการอัปเดต
speedKilometersPerHour optional
ประเภท:  number optional
ความเร็วเป็นกิโลเมตรต่อชั่วโมง
time optional
ประเภท:  Date optional
เวลาที่ได้รับจากการอัปเดตจากยานพาหนะ

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

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

ประเภทจุดบนยานพาหนะ
distanceMeters optional
ประเภท:  number optional
ระยะทางของเส้นทางระหว่างจุดอ้างอิงก่อนหน้า (หรือตําแหน่งปัจจุบันของรถ ถ้าจุดบนเส้นทางนี้เป็นจุดแรกในรายการจุดอ้างอิง) จนถึงจุดอ้างอิงนี้เป็นเมตร
durationMillis optional
ประเภท:  number optional
เวลาในการเดินทางระหว่างจุดอ้างอิงก่อนหน้า (หรือตําแหน่งปัจจุบันของรถ ถ้าจุดบนเส้นทางนี้เป็นจุดแรกในรายการจุดอ้างอิง) เป็นจุดอ้างอิงนี้เป็นมิลลิวินาที
location optional
ประเภท:  LatLngLiteral optional
ตําแหน่งของจุดอ้างอิง
path optional
ประเภท:  Array<LatLngLiteral> optional
เส้นทางจากจุดอ้างอิงก่อนหน้า (หรือตําแหน่งปัจจุบันของรถ ถ้าจุดบนเส้นทางนี้เป็นจุดแรกในรายการของการชี้ทาง) ที่จุดนี้

อินเทอร์เฟซสําหรับยานพาหนะ

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

รายละเอียดของยานพาหนะที่ Fleet Engine ส่งคืน
attributes
ประเภท:  Object<string, *>
แอตทริบิวต์ยานพาหนะที่กําหนดเอง
name
ประเภท:  string
ในรูปแบบ "providers/{provider_id}/vehicles/{vehicle_id}" car_id ต้องเป็นตัวระบุที่ไม่ซ้ํากัน
navigationStatus
ประเภท:  VehicleNavigationStatus
สถานะการนําทางปัจจุบันของยานพาหนะ
remainingDistanceMeters
ประเภท:  number
ระยะทางขับรถที่เหลืออยู่ในส่วนเส้นทางปัจจุบัน หน่วยเป็นเมตร
vehicleState
ประเภท:  VehicleState
สถานะรถยนต์
vehicleType
ประเภท:  VehicleType
ประเภทของยานพาหนะนี้
currentRouteSegmentEndPoint optional
ประเภท:  TripWaypoint optional
จุดบนจุดที่ส่วนของเส้นทางปัจจุบันสิ้นสุด
currentRouteSegmentVersion optional
ประเภท:  Date optional
เวลาที่ตั้งค่าส่วนเส้นทางปัจจุบัน
currentTrips optional
ประเภท:  Array<string> optional
รายการรหัสการเดินทางสําหรับการเดินทางที่กําหนดให้ยานพาหนะคันนี้ในปัจจุบัน
etaToFirstWaypoint optional
ประเภท:  Date optional
เวลาถึงโดยประมาณจะถึงรายการแรกในช่องจุดอ้างอิง
latestLocation optional
ประเภท:  VehicleLocationUpdate optional
ตําแหน่งที่รายงานล่าสุดของยานพาหนะ
maximumCapacity optional
ประเภท:  number optional
จํานวนคนขับทั้งหมดที่รถคันนี้รับได้ ไดรเวอร์จะไม่ได้รับการพิจารณาในค่านี้
supportedTripTypes optional
ประเภท:  Array<TripType> optional
ประเภทการเดินทางที่รถคันนี้รองรับ
waypoints optional
ประเภท:  Array<TripWaypoint> optional
จุดบนเส้นทางที่เหลือที่กําหนดให้กับยานพาหนะนี้
waypointsVersion optional
ประเภท:  Date optional
อัปเดตช่องจุดอ้างอิงครั้งล่าสุด

VehiclenavigationStatus ค่าคงที่

google.maps.journeySharing.VehicleNavigationStatus ค่าคงที่

สถานะการนําทางปัจจุบันของ Vehicle

เข้าถึงโดยโทรไปที่ const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API
ARRIVED_AT_DESTINATION พาหนะอยู่ภายในระยะประมาณ 50 ม. จากจุดหมาย
ENROUTE_TO_DESTINATION มีการนําทางแบบเลี้ยวต่อเลี้ยว และการนําทางในแอปไดรเวอร์ได้เข้าสู่โหมด GUIDED_NAV
NO_GUIDANCE การนําทางของแอปไดรเวอร์อยู่ในโหมด FREE_NAV
OFF_ROUTE พาหนะออกนอกเส้นทางที่แนะนํา
UNKNOWN_NAVIGATION_STATUS สถานะการนําทางที่ไม่ระบุ

VehicleState

google.maps.journeySharing.VehicleState ค่าคงที่

สถานะปัจจุบันของ Vehicle

เข้าถึงโดยโทรไปที่ const {VehicleState} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API
OFFLINE ยานพาหนะไม่ยอมรับการเดินทางใหม่
ONLINE ยานพาหนะยอมรับการเดินทางใหม่
UNKNOWN_VEHICLE_STATE สถานะรถยนต์ที่ไม่รู้จัก

VehicleType

google.maps.journeySharing.VehicleType ค่าคงที่

ประเภทของ Vehicle

เข้าถึงโดยโทรไปที่ const {VehicleType} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API
AUTO รถยนต์
TAXI ยานพาหนะที่ทําหน้าที่เป็นแท็กซี่ (โดยปกติมีสัญญาอนุญาตหรือมีการควบคุม)
TRUCK ยานพาหนะที่มีความจุขนาดใหญ่
TWO_WHEELER จักรยานยนต์ โมเพ็ด หรือยานพาหนะ 2 ล้ออื่นๆ
UNKNOWN ไม่ทราบประเภทยานพาหนะ

TripType ค่าคงที่

google.maps.journeySharing.TripType ค่าคงที่

ประเภทการเดินทางที่ Vehicle รองรับ

เข้าถึงโดยโทรไปที่ const {TripType} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API
EXCLUSIVE การเดินทางนี้เป็นยานพาหนะพิเศษ
SHARED การเดินทางนี้อาจแชร์ยานพาหนะกับการเดินทางอื่นๆ
UNKNOWN_TRIP_TYPE ประเภทการเดินทางที่ไม่รู้จัก

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

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

ประเภท TripWaypoint
distanceMeters optional
ประเภท:  number optional
ระยะทางของเส้นทางระหว่างจุดอ้างอิงก่อนหน้า (หรือตําแหน่งปัจจุบันของรถ ถ้าจุดบนเส้นทางนี้เป็นจุดแรกในรายการจุดอ้างอิง) จนถึงจุดอ้างอิงนี้เป็นเมตร
durationMillis optional
ประเภท:  number optional
เวลาในการเดินทางระหว่างจุดอ้างอิงก่อนหน้า (หรือตําแหน่งปัจจุบันของรถ ถ้าจุดบนเส้นทางนี้เป็นจุดแรกในรายการจุดอ้างอิง) เป็นจุดอ้างอิงนี้เป็นมิลลิวินาที
location optional
ประเภท:  LatLngLiteral optional
ตําแหน่งของจุดอ้างอิง
tripId optional
ประเภท:  string optional
การเดินทางที่เชื่อมโยงกับจุดอ้างอิงนี้
waypointType optional
ประเภท:  WaypointType optional
บทบาทของจุดอ้างอิงนี้ในการเดินทางนี้ เช่น ไปรับหรือไปส่ง

WaypointType ค่าคงที่

google.maps.journeySharing.WaypointType ค่าคงที่

ประเภทจุดอ้างอิงที่ Vehicle รองรับ

เข้าถึงโดยโทรไปที่ const {WaypointType} = await google.maps.importLibrary("journeySharing") ดูห้องสมุดใน Maps JavaScript API
DROP_OFF_WAYPOINT_TYPE จุดจอดส่งผู้โดยสาร
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE จุดระหว่างทางสําหรับจุดหมายต่างๆ ในช่วงการเดินทางหลายจุดหมาย
PICKUP_WAYPOINT_TYPE จุดรับผู้โดยสาร
UNKNOWN_WAYPOINT_TYPE ประเภทจุดอ้างอิงที่ไม่รู้จัก

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

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

ช่วงเวลา
endTime
ประเภท:  Date
เวลาสิ้นสุดของกรอบเวลา (รวม)
startTime
ประเภท:  Date
เวลาเริ่มต้นของกรอบเวลา (รวม)