Khi bạn xác định tuyến đường tốt nhất cho một chuyến đi chung xe, tuyến đường nhanh nhất có thể 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 mình.
API Tuyến đường ưu tiên 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 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 đường do nhà điều hành chọn và tuyến đường đã lái.
Hãy sử dụng cả API Tuyến đường ưu tiên 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ã, bạn phải bật phương thức này. Để biết thêm thông tin về cách bật các phương thức API Tuyến đường ưu tiên, hãy xem bài viết 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 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
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 phần
Tham số hệ thống.
Giá trị mặt nạ trường là một 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, và có thể được theo sau bằng một hoặc nhiều dấu chấm, sau đó là tên trường ở cấp tiếp theo. Nhìn 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:
Để xem ví dụ về cách sử dụng phương thức ComputeCustomRoutes, hãy xem
Ví dụ về cách tính toán tuyến đường tuỳ chỉnh (Beta).
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.
Để xem ví dụ về cách tính phí cầu đường, hãy xem phần Ví dụ về cách tính toán tuyến đường tuỳ chỉnh.