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 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 được điều khiển.
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, 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 đườ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ả 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 phần Ví dụ về cách tính toán Tuyến 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 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.