Package google.maps.routes.v1alpha

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Cho trước một tập hợp các điểm tham chiếu đầu cuối và điểm trung gian cùng với một mục tiêu tuyến đường, tính toán tuyến đường tốt nhất cho mục tiêu tuyến đường. Đồng thời trả về tuyến đường nhanh nhất và tuyến ngắn nhất làm tuyến tham chiếu.

LƯU Ý: Phương thức này 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 (xem các tham số và tiêu đề URL hiện có). Giá trị này là danh sách đường dẫn trường được phân tách bằng dấu phẩy. Hãy xem tài liệu chi tiết về cách tạo đường dẫn trường.

Ví dụ: trong phương thức này:

• Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
• Mặt nạ trường của khoảng cách, thời lượng, mã thông báo và thông tin về phí đường bộ của tuyến đường: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google không khuyến khích việc sử dụng mặt nạ trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ trường ở cấp cao nhất (routes) vì:

• Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
• Việc chỉ chọn những trường mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm vì mọi trường mới mà chúng tôi thêm vào sẽ tự động được đưa vào phản hồi.
• Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

• https://www.googleapis.com/auth/maps-platform.routespreferred

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nhận danh sách các điểm gốc và đích đến rồi trả về một luồng chứa thông tin tuyến đường cho từng tổ hợp điểm khởi hành và đích đến.

LƯU Ý: Phương thức này 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 (xem các tham số và tiêu đề URL hiện có). Giá trị này là danh sách đường dẫn trường được phân tách bằng dấu phẩy. Hãy xem tài liệu chi tiết về cách tạo đường dẫn trường.

Ví dụ: trong phương thức này:

• Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
• Mặt nạ trường thể hiện thời lượng tuyến đường, khoảng cách, trạng thái phần tử, điều kiện và chỉ mục phần tử (ví dụ về chế độ thiết lập phiên bản chính thức): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Điều quan trọng là bạn phải đưa status vào mặt nạ trường vì nếu không tất cả tin nhắn sẽ có vẻ ổn. Google không khuyến khích sử dụng mặt nạ trường phản hồi ký tự đại diện (*) vì:

• Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
• Việc chỉ chọn những trường mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm vì mọi trường mới mà chúng tôi thêm vào sẽ tự động được đưa vào phản hồi.
• Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

• https://www.googleapis.com/auth/maps-platform.routespreferred

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Trả về tuyến đường chính cùng với các tuyến đường thay thế không bắt buộc, dựa trên một tập hợp các điểm trung gian và điểm cuối.

LƯU Ý: Phương thức này 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 tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề URL có sẵn. Giá trị này là danh sách đường dẫn trường được phân tách bằng dấu phẩy. Hãy xem tài liệu chi tiết này về cách tạo đường dẫn trường.

Ví dụ: trong phương thức này:

• Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
• Mặt nạ trường thể hiện thời lượng, khoảng cách và hình nhiều đường ở cấp tuyến đường (ví dụ về cách thiết lập bản phát hành chính thức): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google không khuyến khích việc sử dụng mặt nạ trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ trường ở cấp cao nhất (routes), vì:

• Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
• Việc chỉ chọn những trường mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm vì mọi trường mới mà chúng tôi thêm vào sẽ tự động được đưa vào phản hồi.
• Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

• https://www.googleapis.com/auth/maps-platform.routespreferred

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.