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」欄位。多項工作可共用同一個 track_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
工作結果位置的 setter (「provider」或「LAST_VEHICLE_LOCATION」)。
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 介面

TaskInfo 類型,由 DeliveryVehicleStop 使用。

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 正規化表單 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
Task 目前的執行狀態。
targetTimeWindow optional
類型:  TimeWindow optional
完成工作的時間範圍。
taskOutcome optional
類型:  string optional
嘗試執行 Task 的結果。
taskOutcomeTime optional
類型:  Date optional
供應器設定工作結果的時間。

Trip 介面

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 介面

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 介面

車輛歷程區隔類型

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 介面

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}」。Car_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 駕駛應用程式的導航模式為 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 介面

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
路徑中間隔起點的從零開始索引。