VehicleLocation

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

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 (LocationSensor),
  "isRoadSnapped": boolean,
  "isGpsSensorEnabled": boolean,
  "timeSinceUpdate": integer,
  "numStaleUpdates": integer,
  "rawLocation": {
    object (LatLng)
  },
  "rawLocationTime": string,
  "rawLocationSensor": enum (LocationSensor),
  "rawLocationAccuracy": number,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (LocationSensor),
  "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」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

locationSensor

enum (LocationSensor)

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

isRoadSnapped

boolean

location 是否與道路對齊。

isGpsSensorEnabled

boolean

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

timeSinceUpdate

integer

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

numStaleUpdates
(deprecated)

integer

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

rawLocation

object (LatLng)

原始車輛位置 (未由道路核准者處理)。

rawLocationTime

string (Timestamp format)

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

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

rawLocationSensor

enum (LocationSensor)

原始位置的來源。預設值為 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 (LocationSensor)

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

supplementalLocationAccuracy

number

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

roadSnapped
(deprecated)

boolean

已淘汰:請改用 isRoadSnapped

LocationSensor

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

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