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」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "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 (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」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "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 或 Wi-Fi 存取點。
PASSIVE 行動通信基地台 ID 或 Wi-Fi 存取點。
ROAD_SNAPPED_LOCATION_PROVIDER 行動裝置判斷最有可能的路面位置。
CUSTOMER_SUPPLIED_LOCATION 顧客提供的營業地點資訊來自獨立來源。一般而言,這個值用於來源不是執行驅動程式 SDK 的行動裝置。如果原始來源是由其他列舉值描述,請使用該值。標示為 CUSTOMER_SUPPLIED_LOCATION 的地點通常是透過車輛的 lastLocation.supplemental_location_sensor 提供。
FLEET_ENGINE_LOCATION 由 Fleet Engine 根據可用信號計算出的地點。僅供輸出。如果要求中收到這個值,系統會拒絕。
FUSED_LOCATION_PROVIDER Android 的整合式位置預測提供工具。
CORE_LOCATION Apple 作業系統上的定位資訊供應器。