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 的时间。

使用 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 (LocationSensor)

位置数据提供程序(例如 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 (LocationSensor)

原始位置的来源。默认为 GPS

rawLocationAccuracy

number

rawLocation 的精确度(以半径为单位),以米为单位。

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 (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 客户提供的来自独立来源的位置信息。通常,此值用于从运行 Driver SDK 的移动设备以外的来源提供的位置。如果其他枚举值之一可用于描述原始来源,请使用该值。标记为 CUSTOMER_SUPPLIED_LOCATION 的位置通常通过车辆的 lastLocation.supplemental_location_sensor 提供。
FLEET_ENGINE_LOCATION 由车队引擎根据可用的信号计算的位置。仅限输出。如果在请求中收到此值,系统会将其拒绝。
FUSED_LOCATION_PROVIDER Android 的 Fused Location Provider。
CORE_LOCATION Apple 操作系统上的位置信息提供程序。