VehicleLocation

Vị trí, tốc độ và hướng đi của xe tại một thời điểm.

Biểu diễn dưới dạng 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
}
Các trường
location

object (LatLng)

Vị trí xe. Khi được gửi đến Fleet Engine, vị trí của xe là vị trí GPS. Khi bạn nhận được phản hồi, vị trí của xe có thể là vị trí GPS, vị trí bổ sung hoặc một số vị trí ước đoán khác. Nguồn được chỉ định trong locationSensor.

horizontalAccuracy
(deprecated)

number

Không dùng nữa: Thay vào đó, hãy dùng latlngAccuracy.

latlngAccuracy

number

Độ chính xác của bán kính là location tính bằng mét.

heading

integer

Hướng xe đang di chuyển theo độ. 0 đại diện cho hướng Bắc. Phạm vi hợp lệ là [0,360).

bearingAccuracy
(deprecated)

number

Không dùng nữa: Thay vào đó, hãy dùng headingAccuracy.

headingAccuracy

number

Độ chính xác: heading theo độ.

altitude

number

Độ cao tính theo mét trên WGS84.

verticalAccuracy
(deprecated)

number

Không dùng nữa: Thay vào đó, hãy dùng altitudeAccuracy.

altitudeAccuracy

number

Độ chính xác: altitude tính bằng mét.

speedKmph
(deprecated)

integer

Tốc độ của xe tính bằng kilomet/giờ. Không dùng nữa: Thay vào đó, hãy dùng speed.

speed

number

Vận tốc của xe tính bằng mét/giây

speedAccuracy

number

Độ chính xác: speed tính bằng mét/giây.

updateTime

string (Timestamp format)

Thời điểm location được cảm biến báo cáo theo đồng hồ của cảm biến.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

serverTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm máy chủ nhận được thông tin vị trí.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

locationSensor

enum (LocationSensor)

Nhà cung cấp dữ liệu vị trí (ví dụ: GPS).

isRoadSnapped

boolean

Liệu location có được điều chỉnh theo đường hay không.

isGpsSensorEnabled

boolean

Chỉ nhập. Cho biết liệu cảm biến GPS có được bật trên thiết bị di động hay không.

timeSinceUpdate

integer

Chỉ nhập. Thời gian (tính bằng giây) kể từ khi vị trí này được gửi lần đầu đến máy chủ. Giá trị này sẽ bằng 0 trong lần cập nhật đầu tiên. Nếu không xác định được thời gian (ví dụ: khi ứng dụng khởi động lại), giá trị này sẽ được đặt lại về 0.

numStaleUpdates
(deprecated)

integer

Chỉ nhập. Không dùng nữa: Các tín hiệu khác hiện được dùng để xác định xem một vị trí đã lỗi thời hay chưa.

rawLocation

object (LatLng)

Thông tin vị trí chưa qua xử lý của xe (chưa được trình chụp đường phố xử lý).

rawLocationTime

string (Timestamp format)

Dấu thời gian được liên kết với vị trí thô.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

rawLocationSensor

enum (LocationSensor)

Nguồn của vị trí thô. Giá trị mặc định là GPS.

rawLocationAccuracy

number

Độ chính xác: rawLocation dưới dạng bán kính, tính bằng mét.

supplementalLocation

object (LatLng)

Vị trí bổ sung do ứng dụng tích hợp cung cấp.

supplementalLocationTime

string (Timestamp format)

Dấu thời gian của vị trí bổ sung.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

supplementalLocationSensor

enum (LocationSensor)

Nguồn của vị trí bổ sung. Giá trị mặc định là CUSTOMER_SUPPLIED_LOCATION.

supplementalLocationAccuracy

number

Độ chính xác: supplementalLocation dưới dạng bán kính, tính bằng mét.

roadSnapped
(deprecated)

boolean

Không dùng nữa: Thay vào đó, hãy dùng isRoadSnapped.

LocationSensor

Cảm biến hoặc phương pháp dùng để xác định vị trí.

Enum
UNKNOWN_SENSOR Cảm biến chưa được chỉ định hoặc không xác định.
GPS GPS hoặc GPS được hỗ trợ.
NETWORK Hệ thống định vị toàn cầu (GPS) có hỗ trợ, mã trạm phát sóng hoặc điểm truy cập Wi-Fi.
PASSIVE Điểm truy cập nhận dạng trạm phát sóng hoặc điểm truy cập Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Vị trí được thiết bị di động xác định là vị trí có nhiều khả năng nhất trên đường.
CUSTOMER_SUPPLIED_LOCATION Vị trí do khách hàng cung cấp từ một nguồn độc lập. Thông thường, giá trị này được dùng cho một vị trí được cung cấp từ các nguồn không phải thiết bị di động chạy SDK trình điều khiển. Nếu nguồn ban đầu được mô tả bằng một trong các giá trị enum khác, hãy sử dụng giá trị đó. Vị trí được đánh dấu CUSTOMER_supPLIED_LOCATION thường được cung cấp qua lastLocation.supplemental_location_sensor của xe.
FLEET_ENGINE_LOCATION Vị trí do Fleet Engine tính toán dựa trên các tín hiệu có sẵn. Chỉ có đầu ra. Hệ thống sẽ từ chối giá trị này nếu nhận được trong yêu cầu.
FUSED_LOCATION_PROVIDER Trình cung cấp vị trí kết hợp của Android.
CORE_LOCATION Nhà cung cấp vị trí trên các hệ điều hành của Apple.