Khi bạn xác định tuyến đường tốt nhất cho chuyến đi chung xe, tuyến đường nhanh nhất không phải lúc nào cũng là lựa chọn tốt nhất. Bạn có thể muốn để lên kế hoạch cho tuyến đường của bạn.
API ưu tiên cho tuyến đường cho phép bạn lên kế hoạch cho một tuyến đường bằng cách chỉ định
mục tiêu tuyến đường 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à
theo tuyến đường.
Sử dụng cả API ưu tiên cho tuyến đường và SDK điều hướng để nhận được toàn bộ lợi ích của việc 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ã của mình, bạn phải
bật tính năng đó. Để biết thêm thông tin về cách bật API ưu tiên cho 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 phản hồi
mặt nạ trường trong đầ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
tham 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
System Parameters (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à 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, và không bắt buộc theo sau là một hoặc nhiều dấu chấm, rồi đến cấp độ tiếp theo của tên trường. Nói chung, đường dẫn trường được xây dựng theo cách sau:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mặt nạ trường đặc biệt dạng chữ hoa chữ thường là ký tự đại diện “*”, chọn mọi thông tin ở cấp độ gốc mới.
Để 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 tùy 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 Tính phí cầu đường.
Để biết ví dụ về cách tính phí cầu đường, hãy xem Tính toán ví dụ về tuyến đường tuỳ chỉnh.