Đóng gói thông tin tuyến đường được tính toán cho một cặp điểm khởi hành/đích đến trong API v1alpha.computeRouteMatrix. Proto này có thể được truyền trực tuyến đến ứng dụng khách.
Biểu diễn dưới dạng JSON |
---|
{ "originIndex": integer, "destinationIndex": integer, "status": { object ( |
Các trường | |
---|---|
originIndex |
Chỉ mục gốc 0 của nguồn gốc trong yêu cầu. |
destinationIndex |
Chỉ mục dựa trên giá trị 0 của đích đến trong yêu cầu. |
status |
Mã trạng thái lỗi cho phần tử này. |
condition |
Cho biết đã tìm thấy tuyến đường hay chưa. Không phụ thuộc vào trạng thái. |
distanceMeters |
Khoảng cách đi được của tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng ' |
staticDuration |
Thời gian đi qua tuyến đường mà không tính đến tình trạng giao thông. Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng ' |
travelAdvisory |
Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về thu phí cầu đường |
fallbackInfo |
Trong một số trường hợp khi không thể tính toán tuyến đường với các tuỳ chọn đã cho cho cặp điểm gốc/đích cụ thể này, máy chủ có thể quay lại sử dụng chế độ tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt. |
Trạng thái
Loại Status
xác định một mô hình lỗi logic phù hợp với nhiều môi trường lập trình, bao gồm cả API REST và API RPC. gRPC sử dụng khoá này. Mỗi thông báo Status
chứa 3 phần dữ liệu: mã lỗi, thông báo lỗi và thông tin chi tiết về lỗi.
Bạn có thể tìm hiểu thêm về mô hình lỗi này và cách xử lý lỗi trong Hướng dẫn thiết kế API.
Biểu diễn dưới dạng JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Các trường | |
---|---|
code |
Mã trạng thái, phải là giá trị enum của |
message |
Một thông báo lỗi dành cho nhà phát triển, phải bằng tiếng Anh. Mọi thông báo lỗi dành cho người dùng phải được bản địa hoá và gửi trong trường |
details[] |
Danh sách các thông báo chứa thông tin chi tiết về lỗi. Có một tập hợp các loại thông báo phổ biến để API sử dụng. Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung |