Khi bạn đang xác định tuyến đường tốt nhất cho 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 Ưu tiên tuyế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 do người vận hành chọn và tuyến đường đã đi.
Sử dụng cả API Ưu tiên về 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
Để 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 về 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 nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ cho trường (field mask) của phản hồi bằng cách sử dụng tham số URL $fields hoặc fields, hoặc 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ạ cho trường (field mask) 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 biểu thị 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 có thể 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ạ cho trường (field mask) đặc biệt là một ký tự đại diện “*", giúp 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 bài viết Ví dụ về tính toán tuyến đường tùy chỉnh (phiên bản thử nghiệm 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 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 Tính toán ví dụ về tuyến đường tuỳ chỉnh.