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 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.
Routes Preferred API cho phép bạn lập 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 bạn 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 xe.
Sử dụng cả Routes Preferred API và Navigation SDK để khai thá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 của Routes Preferred API, 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 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ể theo sau là một hoặc nhiều dấu chấm, sau đó là cấp tiếp theo của tên trường. Nhìn chung, đường dẫn trường được tạo theo cách sau:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mặt nạ trường theo 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 phần Ví dụ về cách tính toán tuyến đường tuỳ chỉnh.
Đ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.
Để biết 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 đường tuỳ chỉnh.