REST Resource: projects.trips

Tài nguyên: Chuyến đi

Một chuyến đi.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên tài nguyên của chuyến đi. Định dạng: projects/{project_number}/trips/{tripId}.
config

object (TripConfig)

Không thể thay đổi. Cấu hình cho chuyến đi.
androidAppId

string

Chỉ nhập. Không thể thay đổi. Mã ứng dụng Android của ứng dụng di động sẽ sử dụng chuyến đi. Bạn phải đặt ít nhất một trong androidAppId hoặc iosAppId.
iosAppId

string

Chỉ có đầu vào. Không thể thay đổi. Mã nhận dạng gói iOS của ứng dụng di động sẽ sử dụng chuyến đi. Bạn phải đặt ít nhất một trong hai thuộc tính androidAppId hoặc iosAppId.
authToken

object (AuthToken)

Chỉ có đầu ra. Một mã thông báo không công khai cho phép truy cập để bắt đầu một chuyến đi bằng NavConnect trong Google Maps hoặc Waze và cấp cho các ứng dụng này quyền cập nhật chuyến đi. Chỉ được trips.create trả về.
state

enum (State)

Chỉ có đầu ra. Trạng thái của Chuyến đi.
execution

object (TripExecution)

Chỉ có đầu ra. Dữ liệu mới nhất về việc thực hiện chuyến đi. Bạn không thể đặt giá trị này nếu chuyến đi đang ở trạng thái lỗi.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian theo máy chủ khi chuyến đi được tạo.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian mà máy chủ nhận được thông tin cập nhật mới nhất về chuyến đi.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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".

TripConfig

Cấu hình cho chuyến đi.

Biểu diễn dưới dạng JSON 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string,
  "enableRemainingRouteReporting": boolean
}
Trường
enableHighFrequencyUpdates

boolean

Không bắt buộc. Chọn có bật tính năng cập nhật thông tin chuyến đi ở tần suất cao hay không.

LƯU Ý: Khi bạn bật tính năng này, chuyến đi sẽ được ghi lại trong mức sử dụng Cấp doanh nghiệp và phải chịu mức phí của Cấp doanh nghiệp.
enablePubsub

boolean

Không bắt buộc. Có bật thông báo pubsub cho chuyến đi hay không.
pubsubFieldMask

string (FieldMask format)

Không bắt buộc. Nếu được đặt, chỉ tập hợp con được chỉ định của các trường Chuyến đi sẽ được đưa vào thông báo pubsub.

Nếu bạn không đặt, tất cả các trường Trip sẽ được đưa vào thông báo pubsub (hành vi mặc định).

Các trường sau không được hỗ trợ:

  • androidAppId
  • iosAppId
  • authToken
  • config

LƯU Ý: Trường này sẽ bị bỏ qua nếu enablePubsub có giá trị là false.

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
enableRemainingRouteReporting

boolean

Không bắt buộc. Chọn có bật tính năng báo cáo tuyến đường còn lại cho chuyến đi hay không.

LƯU Ý: Khi bạn bật tính năng này, chuyến đi sẽ được ghi lại trong mức sử dụng Cấp doanh nghiệp và phải chịu mức phí của Cấp doanh nghiệp.

AuthToken

Mã thông báo xác thực.

Biểu diễn dưới dạng JSON 
{
  "token": string,
  "expireTime": string
}
Trường
token

string

Chỉ có đầu ra. Mã thông báo xác thực cần được chuyển đến ứng dụng di động.
expireTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian mã thông báo xác thực sẽ hết hạn.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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".

Tiểu bang

Tất cả các trạng thái có thể có của chuyến đi.

Enum
STATE_UNSPECIFIED Trạng thái chuyến đi chưa được chỉ định.
NEW Chuyến đi đã được tạo nhưng chưa bắt đầu.
ENROUTE Xe vận chuyển đang trên đường đến điểm đến.
ARRIVED Xe vận chuyển đã đến nơi.
SUSPENDED Chuyến đi bị tạm ngưng.
FAILED Chuyến đi không hoàn tất thành công.
CLIENT_ERROR Chuyến đi không thành công do lỗi phía máy khách.
CANCELED Nhà phát triển đã huỷ chuyến đi một cách rõ ràng.

TripExecution

Dữ liệu về việc thực hiện chuyến đi.

Biểu diễn dưới dạng JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Trường
origin

object (Location)

Chỉ có đầu ra. Điểm xuất phát của chuyến đi, thường là vị trí của người vận chuyển khi bắt đầu chuyến đi NavConnect.
destination

object (Stop)

Chỉ có đầu ra. Điểm đến của chuyến đi do ứng dụng di động báo cáo.
location

object (Location)

Chỉ có đầu ra. Tín hiệu vị trí biểu thị vị trí đã biết gần đây nhất của người vận chuyển. Đây sẽ là vị trí được gắn vào đường nếu có.
remainingRoute

object (Route)

Chỉ có đầu ra. Cung cấp hình nhiều đường cho phần còn lại của tuyến đường.
traveledDuration

string (Duration format)

Chỉ có đầu ra. Thời gian đã đi được cho đến nay.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân và kết thúc bằng "s". Ví dụ: "3.5s".
remainingDuration

string (Duration format)

Chỉ có đầu ra. Thời gian còn lại của chuyến đi theo ước tính của Google.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân và kết thúc bằng "s". Ví dụ: "3.5s".
traveledDistanceMeters

integer

Chỉ có đầu ra. Khoảng cách đã đi từ điểm khởi hành (tính bằng mét).
remainingDistanceMeters

integer

Chỉ có đầu ra. Khoảng cách còn lại đến điểm đến tính bằng mét.
stopAddedInRoute

boolean

Chỉ có đầu ra. Cho biết bạn có thêm một điểm dừng dọc theo tuyến đường hay không.

Thông tin vị trí

Vị trí do ứng dụng di động báo cáo.

Biểu diễn dưới dạng JSON 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Trường
point

object (LatLng)

Chỉ có đầu ra. Vĩ độ/kinh độ của vị trí.
sourceTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian vị trí được lấy nguồn theo chỉ định của ứng dụng.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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à máy chủ nhận được thông báo cập nhật vị trí này.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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".

LatLng

Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Thông tin này được biểu thị dưới dạng một cặp số thực có độ chính xác kép để biểu thị vĩ độ và kinh độ theo độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi được chuẩn hoá.

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

Dừng

Một điểm dừng trong chuyến đi để thực hiện một việc nào đó.

Biểu diễn dưới dạng JSON 
{
  "point": {
    object (LatLng)
  }
}
Trường
point

object (LatLng)

Bắt buộc. Vị trí của điểm dừng dưới dạng vĩ độ/kinh độ.

Tuyến đường

Một hình nhiều đường của tuyến đường.

Biểu diễn dưới dạng JSON 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
Trường
trafficInformation[]

object (SpeedReadingInterval)

Chỉ có đầu ra. Thông tin giao thông trên đường nhiều đoạn được mô tả là khoảng thời gian đọc tốc độ.

LƯU Ý:

  • Các khoảng thời gian không chồng chéo nhau.
  • Các khoảng thời gian là liên tục.
  • Các khoảng thời gian bao phủ toàn bộ đường nhiều đường.
  • Các khoảng thời gian được sắp xếp theo chỉ mục tăng dần.
  • Tốc độ được chỉ định cho từng khoảng thời gian.

Trường nhóm format. Định dạng tuyến đường.

Định dạng được điền sẵn do tham số route_polyline_format kiểm soát. Nếu không được đặt, thì giá trị mặc định sẽ là một đường nhiều đoạn đơn giản. format chỉ có thể là một trong những trạng thái sau:
simplePolyline

object (SimplePolyline)

Chỉ có đầu ra. Tuyến đường dưới dạng danh sách đơn giản gồm các latlng.
encodedPolyline

string

Chỉ có đầu ra. Tuyến đường dưới dạng một đường nhiều đường được mã hoá. Hãy xem https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
s2Polyline

string (bytes format)

Chỉ có đầu ra. Tuyến đường dưới dạng S2Polyline được mã hoá. Hãy xem https://s2geometry.io/devguide/basic_types.html.

Một chuỗi được mã hoá base64.
geoJson

object (Struct format)

Chỉ có đầu ra. Tuyến đường dưới dạng GeoJSON LineString. Hãy xem https://tools.ietf.org/html/rfc7946#section-3.1.4.

SimplePolyline

Biểu thị một đường nhiều đoạn bằng cách sử dụng danh sách đơn giản gồm các điểm.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
Trường
points[]

object (LatLng)

Chỉ có đầu ra. Danh sách các điểm theo thứ tự đại diện cho đường nhiều đoạn.

SpeedReadingInterval

Chỉ báo mật độ giao thông trên một đoạn đường liên tục. Cho trước một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục từ 0), SpeedReadingInterval xác định một khoảng thời gian và mô tả lưu lượng truy cập của khoảng thời gian đó bằng cách sử dụng các danh mục Speed.

Biểu diễn dưới dạng JSON 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
Trường
speed

enum (Speed)

Chỉ có đầu ra. Tốc độ giao thông trong khoảng thời gian này.
startPolylinePointIndex

integer

Chỉ có đầu ra. Chỉ mục bắt đầu của khoảng thời gian này trong đường dẫn.
endPolylinePointIndex

integer

Chỉ có đầu ra. Chỉ mục kết thúc của khoảng thời gian này trong đường dẫn.

Tốc độ

Phân loại tốc độ của hình nhiều đường dựa trên dữ liệu giao thông.

Enum
SPEED_UNSPECIFIED Tốc độ chưa được chỉ định.
NORMAL Tốc độ bình thường, không có trở ngại giao thông.
SLOW Đã phát hiện tình trạng giảm tốc độ, lưu lượng giao thông từ thấp đến trung bình.
TRAFFIC_JAM Tình trạng tắc nghẽn giao thông, kể cả tình trạng giao thông ùn tắc.

Phương thức

create

 Tạo một chuyến đi.

get

 Lấy một chuyến đi.