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,
  "flpLocation": {
    object (LatLng)
  },
  "flpUpdateTime": string,
  "flpLatlngAccuracyMeters": number,
  "flpHeadingDegrees": integer,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (LocationSensor),
  "supplementalLocationAccuracy": number,
  "roadSnapped": boolean
}
Trường
location

object (LatLng)

Vị trí của xe. Khi được gửi đến Fleet Engine, vị trí của xe là vị trí GPS. Khi bạn nhận được vị trí này trong một 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 sử dụng latlngAccuracy.

latlngAccuracy

number

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

heading

integer

Hướng di chuyển của xe tính bằng độ. 0 biểu thị 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 sử dụng headingAccuracy.

headingAccuracy

number

Độ chính xác của heading tính bằng độ.

altitude

number

Độ cao tính bằng mét so với WGS84.

verticalAccuracy
(deprecated)

number

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

altitudeAccuracy

number

Độ chính xác là altitude mét.

speedKmph
(deprecated)

integer

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

speed

number

Tốc độ của xe tính bằng mét/giây

speedAccuracy

number

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

updateTime

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

serverTime

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

locationSensor

enum (LocationSensor)

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

isRoadSnapped

boolean

location có được gắn vào một con đường hay không.

isGpsSensorEnabled

boolean

Chỉ có đầu vào. 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ỉ có đầu vào. Thời gian (tính bằng giây) kể từ khi vị trí này được gửi đến máy chủ lần đầu tiên. Giá trị này sẽ bằng 0 cho 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ẽ đặt lại thành 0.

numStaleUpdates
(deprecated)

integer

Chỉ có đầu vào. Không dùng nữa: Giờ đây, các tín hiệu khác được dùng để xác định xem một vị trí có còn mới hay không.

rawLocation

object (LatLng)

Vị trí thô của xe (chưa được xử lý bằng tính năng gắn vị trí vào đường).

rawLocationTime

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

rawLocationSensor

enum (LocationSensor)

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

rawLocationAccuracy

number

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

flpLocation

object (LatLng)

Vị trí do Trình cung cấp vị trí kết hợp của Android cung cấp.

flpUpdateTime

string (Timestamp format)

Dấu thời gian cập nhật của flpLocation

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

flpLatlngAccuracyMeters

number

Độ chính xác của flpLocation tính bằng mét theo bán kính.

flpHeadingDegrees

integer

Hướng di chuyển của xe theo độ, do Trình cung cấp vị trí kết hợp xác định. 0 biểu thị hướng Bắc. Phạm vi hợp lệ là [0,360).

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 liên kết với vị trí bổ sung.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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 của 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 sử dụng isRoadSnapped.

LocationSensor

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

Enum
UNKNOWN_SENSOR Cảm biến không được chỉ định hoặc không xác định.
GPS GPS hoặc GPS hỗ trợ.
NETWORK GPS hỗ trợ, mã nhận dạng trạm phát sóng hoặc điểm truy cập Wi-Fi.
PASSIVE Mã 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í do thiết bị di động xác định là vị trí có khả năng cao 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í do các nguồn khác cung cấp, không phải thiết bị di động đang chạy Driver SDK. 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ị đó. Những vị trí được đánh dấu là CUSTOMER_SUPPLIED_LOCATION thường được cung cấp thông 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. Giá trị này sẽ bị từ chối nếu được nhận trong một yêu cầu.
FUSED_LOCATION_PROVIDER Trình cung cấp vị trí kết hợp của Android.
CORE_LOCATION Trình cung cấp vị trí trên hệ điều hành Apple.