Khi bạn xác định tuyến đường tốt nhất cho một chuyến đi chung xe, không phải lúc nào tuyến đường nhanh nhất cũng là lựa chọn tốt nhất. Bạn nên lên kế hoạch cho tuyến đường của mình.
API Routes Preferred cho phép bạn lập kế hoạch tuyến bằng cách chỉ định mục tiêu tuyến bằng phương thức ComputeCustomRoutes
.
Phương thức ComputeCustomRoutes
cũng có thể giúp đảm bảo việc tuân thủ tuyến đường bằng cách cho phép bạn giảm thiểu sự khác biệt giữa tuyến do nhà vận hành chọn và tuyến đường đã lái.
Sử dụng cả API Routes Preferred và Navigation SDK để khai thác tối đa lợi ích của tính năng lập kế hoạch tuyến đường.
Bật phương thức ComputeCustomRoutes
Trước khi có thể sử dụng phương thức ComputeCustomRoutes
trong mã, bạn phải bật phương thức đó. Để biết thêm thông tin về cách bật các phương thức API ưu tiên của Tuyến đường, hãy xem phần Bắt đầu.
Sử dụng phương thức ComputeCustomRoutes
Phương thức ComputeCustomRoutes
yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách sử dụng thông số URL $fields
hoặc fields
hoặc bằng cách sử dụng tiêu đề HTTP/gRPC X-Goog-FieldMask
. Để biết thêm thông tin, hãy xem phần Tham số hệ thống.
Giá trị mặt nạ trường là danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Mỗi đường dẫn trường là một danh sách tên trường được phân tách bằng dấu chấm, đại diện cho hệ phân cấp thông báo. Tên trường là khoá đối tượng JSON hoặc tên thẻ trường protobuf. Đường dẫn trường bắt đầu từ loại thông báo phản hồi cấp cao nhất, theo sau là một hoặc nhiều dấu chấm (không bắt buộc), sau đó là cấp tiếp theo của tên trường. Nói chung, đường dẫn trường được tạo theo cách sau:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mặt nạ trường trường hợp đặc biệt là ký tự đại diện “*”, chọn tất cả các trường ở cấp độ gốc.
Để biết thêm thông tin, hãy xem các bài viết sau:
Để biết ví dụ về cách sử dụng phương thức ComputeCustomRoutes
, hãy xem Ví dụ về tính toán tuyến đường tuỳ chỉnh (Beta).
Đang tính phí cầu đường
Để biết thông tin về cách tính phí cầu đường, hãy xem phần Tính phí cầu đường.
Để xem ví dụ về cách tính phí cầu đường, hãy xem phần Ví dụ về cách tính tuyến tuỳ chỉnh.