DeliveryVehicleLocation

車輛在特定時間點的位置、速度和航向。

JSON 表示法
{
  "location": {
    object (LatLng)
  },
  "horizontalAccuracy": number,
  "latlngAccuracy": number,
  "heading": integer,
  "bearingAccuracy": number,
  "headingAccuracy": number,
  "altitude": number,
  "verticalAccuracy": number,
  "altitudeAccuracy": number,
  "speedKmph": integer,
  "speed": number,
  "speedAccuracy": number,
  "updateTime": string,
  "serverTime": string,
  "locationSensor": enum (DeliveryVehicleLocationSensor),
  "isRoadSnapped": boolean,
  "isGpsSensorEnabled": boolean,
  "timeSinceUpdate": integer,
  "numStaleUpdates": integer,
  "rawLocation": {
    object (LatLng)
  },
  "rawLocationTime": string,
  "rawLocationSensor": enum (DeliveryVehicleLocationSensor),
  "rawLocationAccuracy": number,
  "flpLocation": {
    object (LatLng)
  },
  "flpUpdateTime": string,
  "flpLatlngAccuracyMeters": number,
  "flpHeadingDegrees": integer,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (DeliveryVehicleLocationSensor),
  "supplementalLocationAccuracy": number,
  "roadSnapped": boolean
}
欄位
location

object (LatLng)

車輛位置。傳送至 Fleet Engine 的車輛位置是 GPS 位置。當您在回覆中收到這項資訊時,車輛位置可能是 GPS 位置、輔助位置或其他預估位置。來源是在 locationSensor 中指定。

horizontalAccuracy
(deprecated)

number

已淘汰:請改用 latlngAccuracy

latlngAccuracy

number

準確度為 location 公尺 (半徑)。

heading

integer

車輛行進方向 (以角度表示)。0 代表北方。有效範圍為 [0,360)。

bearingAccuracy
(deprecated)

number

已淘汰:請改用 headingAccuracy

headingAccuracy

number

準確度為 heading 度。

altitude

number

以高於 WGS84 的公尺數表示。

verticalAccuracy
(deprecated)

number

已淘汰:請改用 altitudeAccuracy

altitudeAccuracy

number

準確度為 altitude 公尺。

speedKmph
(deprecated)

integer

車輛速度 (以公里/小時為單位)。已淘汰:請改用 speed

speed

number

車輛速度 (以公尺/秒為單位)

speedAccuracy

number

準確度,單位為公尺/秒。speed

updateTime

string (Timestamp format)

感應器回報 location 的時間 (以感應器的時鐘為準)。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

serverTime

string (Timestamp format)

僅供輸出。伺服器收到位置資訊的時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

locationSensor

enum (DeliveryVehicleLocationSensor)

位置資料供應商 (例如 GPS)。

isRoadSnapped

boolean

location 是否已對齊道路。

isGpsSensorEnabled

boolean

僅限輸入。指出行動裝置是否已啟用 GPS 感應器。

timeSinceUpdate

integer

僅限輸入。自這個位置資訊首次傳送至伺服器以來經過的時間 (以秒為單位)。第一次更新時,這個值會是零。如果時間不明 (例如應用程式重新啟動時),這個值會重設為零。

numStaleUpdates
(deprecated)

integer

僅限輸入。已淘汰:現在會使用其他信號判斷位置資訊是否過時。

rawLocation

object (LatLng)

車輛原始位置 (未經道路吸附處理)。

rawLocationTime

string (Timestamp format)

與原始位置資訊相關聯的時間戳記。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

rawLocationSensor

enum (DeliveryVehicleLocationSensor)

原始位置的來源。預設值為 GPS

rawLocationAccuracy

number

以公尺為單位的半徑 rawLocation 精確度。

flpLocation

object (LatLng)

Android 整合式位置預測提供工具提供的位置資訊。

flpUpdateTime

string (Timestamp format)

更新 flpLocation 的時間戳記

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

flpLatlngAccuracyMeters

number

準確度為 flpLocation 公尺 (半徑)。

flpHeadingDegrees

integer

車輛的移動方向 (以度為單位),由 Fused Location Provider 判斷。0 代表北方。有效範圍為 [0,360)。

supplementalLocation

object (LatLng)

整合應用程式提供的補充位置資訊。

supplementalLocationTime

string (Timestamp format)

與補充地點相關聯的時間戳記。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

supplementalLocationSensor

enum (DeliveryVehicleLocationSensor)

補充位置資訊的來源。預設值為 CUSTOMER_SUPPLIED_LOCATION

supplementalLocationAccuracy

number

以公尺為單位的半徑 supplementalLocation 精確度。

roadSnapped
(deprecated)

boolean

已淘汰:請改用 isRoadSnapped

DeliveryVehicleLocationSensor

用於判斷位置的感應器或方法。

列舉
UNKNOWN_SENSOR 感應器未指定或不明。
GPS GPS 或輔助 GPS。
NETWORK 輔助全球衛星定位系統、行動通信基地台 ID 或 Wi-Fi 存取點。
PASSIVE 行動通信基地台 ID 或 Wi-Fi 存取點。
ROAD_SNAPPED_LOCATION_PROVIDER 行動裝置判斷最有可能的道路位置。
CUSTOMER_SUPPLIED_LOCATION 顧客從獨立來源提供的位置資訊。通常這個值用於從執行 Driver SDK 的行動裝置以外來源提供的位置資訊。如果原始來源是由其他列舉值描述,請使用該值。標示為 CUSTOMER_SUPPLIED_LOCATION 的位置通常是透過 DeliveryVehicle 的 lastLocation.supplemental_location_sensor 提供。
FLEET_ENGINE_LOCATION Fleet Engine 根據可用的信號計算出的位置。僅供輸出。如果要求中包含這個值,系統會拒絕要求。
FUSED_LOCATION_PROVIDER Android 的整合式位置預測提供工具。
CORE_LOCATION Apple 作業系統上的位置資訊供應商。