Fleet Engine Entities

Task 介面

google.maps.journeySharing.Task 介面

Fleet Engine 傳回的工作詳細資料。
attributes
類型：  Object<string, *>
指派給工作的屬性。
name
類型：  string
任務名稱的格式為「providers/{provider_id}/tasks/{task_id}」。task_id 必須是專屬 ID，而非追蹤 ID。如要儲存貨物的追蹤 ID，請使用 tracking_id 欄位。多個工作可以使用相同的 tracking_id。
remainingVehicleJourneySegments
這項工作的剩餘區隔資訊。
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」) 的 setter。
outcomeTime optional
類型：  Date optional
設定工作結果的時間戳記 (來自供應器)。
plannedLocation optional
類型：  LatLngLiteral optional
工作完成的位置。
targetTimeWindow optional
類型：  TimeWindow optional
應完成工作時段。
trackingId optional
類型：  string optional
貨物的追蹤 ID。
vehicleId optional
類型：  string optional
執行此項工作的車輛 ID。

TaskInfo 介面

google.maps.journeySharing.TaskInfo 介面

DeliveryVehicleStop 使用的 TaskInfo 類型。
extraDurationMillis optional
類型：  number optional
執行工作所需的額外時間 (以毫秒為單位)。
id optional
類型：  string optional
任務的 ID。
targetTimeWindow optional
類型：  TimeWindow optional
應完成工作時段。

TaskTrackingInfo 介面

google.maps.journeySharing.TaskTrackingInfo 介面

Fleet Engine 傳回的工作追蹤資訊物件詳細資料。
attributes
類型：  Object<string, *>
指派給工作的屬性。
name
類型：  string
名稱格式為「providers/{provider_id}/taskTrackingInfo/{tracking_id}」，其中 tracking_id 代表追蹤 ID。
trackingId
類型：  string
工作單元的追蹤 ID。
  • 必須是有效的 Unicode 字串。
  • 長度上限為 64 個半形字元。
  • 根據 Unicode Normalization Form 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}」。trip_id 必須是專屬 ID。
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
進行這趟行程的車輛 ID。
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
消費者指定的取貨地點。

DeliveryVehicle 介面

google.maps.journeySharing.DeliveryVehicle 介面

Fleet Engine 傳回的運送車輛詳細資料。
attributes
類型：  Object<string, string optional>
自訂送貨車輛屬性。
name
類型：  string
格式為「providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}」。delivery_vehicle_id 必須是專屬 ID。
navigationStatus
類型：  string
車輛目前的導航狀態。
remainingDistanceMeters
類型：  number
目前路線路段的剩餘行駛距離 (以公尺為單位)。
remainingVehicleJourneySegments
指派給這輛運送車輛的行程路段，從車輛最近回報的位置開始。只有在透過 FleetEngineDeliveryVehicleLocationProvider 提供 DeliveryVehicle 資料物件時，才會填入這個值。
currentRouteSegmentEndPoint optional
類型：  LatLngLiteral optional
目前路線路段的終點位置。
latestVehicleLocationUpdate optional
類型：  VehicleLocationUpdate optional
送貨車輛上次回報的位置。
remainingDurationMillis optional
類型：  number optional
目前路線路段的剩餘行車時間 (以毫秒為單位)。

DeliveryVehicleStop 介面

google.maps.journeySharing.DeliveryVehicleStop 介面

送貨車輛停靠站類型
tasks
類型：  Array<TaskInfo>
此停靠站要執行的工作清單。
  • id：工作 ID。
  • extraDurationMillis：執行工作所需的額外時間，以毫秒為單位。
plannedLocation optional
類型：  LatLngLiteral optional
停靠站的位置。
state optional
類型：  DeliveryVehicleStopState optional
停靠站的狀態。

DeliveryVehicleStopState 常數

google.maps.journeySharing.DeliveryVehicleStopState 常數

DeliveryVehicleStop 的目前狀態。

請呼叫 const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing") 存取。請參閱「Maps JavaScript API 中的程式庫」。
ARRIVED 已抵達停靠站。假設車輛在前往下一個停靠站的路線上，已完成所有前一個停靠站的作業。
ENROUTE 已指派並積極轉送。
NEW 已建立，但未積極路由。
UNSPECIFIED 未知。

VehicleJourneySegment 介面

google.maps.journeySharing.VehicleJourneySegment 介面

VehicleJourneySegment 類型
drivingDistanceMeters optional
類型：  number optional
從前一個停靠站到這個停靠站的移動距離，以公尺為單位。
drivingDurationMillis optional
類型：  number optional
從前一個停靠站到這個停靠站的車程時間，以毫秒為單位。
path optional
類型：  Array<LatLngLiteral> optional
從前一個停靠站 (或車輛目前位置，如果這個停靠站是停靠站清單中的第一個) 到這個停靠站的路徑。
stop optional
類型：  DeliveryVehicleStop optional
停靠站的相關資訊。

VehicleLocationUpdate 介面

google.maps.journeySharing.VehicleLocationUpdate 介面

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
從上一個路線控點 (或車輛目前位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點的路徑。
speedReadingIntervals optional
類型：  Array<SpeedReadingInterval> optional
從上一個路徑點 (或車輛位置) 到目前路徑點的路徑上，交通速度的清單。清單中的每個間隔都會說明路徑上相鄰片段的流量，而間隔會透過索引定義片段的起點和終點。詳情請參閱 SpeedReadingInterval 的定義。

Vehicle 介面

google.maps.journeySharing.Vehicle 介面

Fleet Engine 傳回的車輛詳細資料。
attributes
類型：  Object<string, *>
自訂車輛屬性。
name
類型：  string
格式為「providers/{provider_id}/vehicles/{vehicle_id}」。vehicle_id 必須是專屬 ID。
navigationStatus
車輛目前的導航狀態。
remainingDistanceMeters
類型：  number
目前路線路段的剩餘行駛距離 (以公尺為單位)。
vehicleState
類型：  VehicleState
車輛狀態。
vehicleType
類型：  VehicleType
車輛類型。
currentRouteSegmentEndPoint optional
類型：  TripWaypoint optional
目前路線路段的終點路標。
currentRouteSegmentVersion optional
類型：  Date optional
目前路線區段的設定時間。
currentTrips optional
類型：  Array<string> optional
目前分配給這輛車輛的行程 ID 清單。
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 Driver 應用程式的導航功能處於 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 機車、輕型機車或其他兩輪車輛。
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 介面

行程路線點類型。
distanceMeters optional
類型：  number optional
這個路線控點與前一個路線控點 (或車輛目前位置，如果這個路線控點是路線控點清單中的第一個) 之間的路徑距離 (以公尺為單位)。
durationMillis optional
類型：  number optional
從上一個路線控點 (或車輛目前位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點之間的時間，以毫秒為單位。
location optional
類型：  LatLng optional
航點的位置。
path optional
類型：  Array<LatLng> optional
從前一個停靠站 (或車輛目前位置，如果這個停靠站是停靠站清單中的第一個) 到這個停靠站的路徑。
speedReadingIntervals optional
類型：  Array<SpeedReadingInterval> optional
從上一個路徑點 (或車輛位置) 到目前路徑點的路徑上，交通速度的清單。清單中的每個間隔都會說明路徑上相鄰片段的流量，而間隔會透過索引定義片段的起點和終點。詳情請參閱 SpeedReadingInterval 的定義。
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 不明的路標類型。

TimeWindow 介面

google.maps.journeySharing.TimeWindow 介面

時間範圍。
endTime
類型：  Date
時間範圍的結束時間 (包含在內)。
startTime
類型：  Date
時間範圍的開始時間 (包含在內)。

速度常數

google.maps.journeySharing.Speed 常數

根據交通資料分類多邊形速度。

請呼叫 const {Speed} = await google.maps.importLibrary("journeySharing") 存取。請參閱「Maps JavaScript API 中的程式庫」。
NORMAL 正常速度，未偵測到速度變慢。
SLOW 偵測到車流量減緩，但未形成交通壅塞。
TRAFFIC_JAM 系統偵測到交通壅塞。

SpeedReadingInterval 介面

google.maps.journeySharing.SpeedReadingInterval 介面

連續路徑區段的交通密度指標。間隔會透過索引定義區段的起點和終點。
endPolylinePointIndex
類型：  number
路徑中間隔結尾點的索引，從零開始。
speed
類型：  Speed
這個間隔內的車流速度。
startPolylinePointIndex
類型：  number
路徑中間隔的起點，索引從零開始。