Đóng gói thông tin tuyến đường được tính toán cho cặp điểm khởi hành/đích trong API v1alpha.computeRouteMatrix. Proto này có thể được truyền trực tuyến đến máy khách.
Biểu diễn dưới dạng JSON |
---|
{ "originIndex": integer, "destinationIndex": integer, "status": { object ( |
Trường | |
---|---|
originIndex |
Chỉ mục gốc 0 của nguồn gốc trong yêu cầu. |
destinationIndex |
Chỉ mục từ 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 liệu có tìm thấy tuyến đường hay không. Không phụ thuộc vào trạng thái. |
distanceMeters |
Khoảng cách đi lại 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 đặt Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
staticDuration |
Thời gian di chuyển trên 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 với 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à phí cầu đường |
fallbackInfo |
Trong một số trường hợp khi máy chủ không thể tính toán tuyến đường bằng các lựa chọn ưu tiên đã cho cho cặp điểm đi/đích cụ thể này, máy chủ có thể quay lại sử dụng một 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ô 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. Hàm này được gRPC sử dụng. 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 cũng như cách xử lý 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: ..., ... } ] } |
Trường | |
---|---|
code |
Mã trạng thái, phải là một giá trị enum của |
message |
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 đều 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 nhóm loại thông báo phổ biến để API sử dụng. Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung |