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,
  "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 的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

serverTime

string (Timestamp format)

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

RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

locationSensor

enum (DeliveryVehicleLocationSensor)

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

isRoadSnapped

boolean

location 是否已對齊道路。

isGpsSensorEnabled

boolean

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

timeSinceUpdate

integer

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

numStaleUpdates
(deprecated)

integer

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

rawLocation

object (LatLng)

原始車輛位置 (未經過道路擷取器處理)。

rawLocationTime

string (Timestamp format)

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

RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

rawLocationSensor

enum (DeliveryVehicleLocationSensor)

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

rawLocationAccuracy

number

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

supplementalLocation

object (LatLng)

整合應用程式提供的額外位置資訊。

supplementalLocationTime

string (Timestamp format)

與補充位置相關聯的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

supplementalLocationSensor

enum (DeliveryVehicleLocationSensor)

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

supplementalLocationAccuracy

number

半徑為 supplementalLocation 的準確度 (以公尺為單位)。

roadSnapped
(deprecated)

boolean

已淘汰:請改用 isRoadSnapped

DeliveryVehicleLocationSensor

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

列舉
UNKNOWN_SENSOR 感應器未指定或不明。
GPS GPS 或輔助 GPS。
NETWORK 輔助 GPS、行動通信基地台 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 作業系統上的地點資訊供應器。