Khi bạn đang xác định tuyến đường tốt nhất cho một 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 nên lên kế hoạch cho tuyến đường của mình.
API Ưu tiên 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 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 đã lái.
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
Bạn phải bật phương thức ComputeCustomRoutes trước khi có thể sử dụng 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 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 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 hay tiêu đề HTTP/gRPC X-Goog-FieldMask. Để biết thêm thông tin, hãy xem bài viết 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, 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 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 bài viết 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.