Package google.maps.routes.v1alpha

Chỉ mục

RoutesAlpha

API Ưu tiên về tuyến đường.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Cho một tập hợp các điểm cuối và trung gian, cùng với một mục tiêu tuyến, sẽ tính toán tuyến tốt nhất cho mục tiêu tuyến. Đồng thời trả về tuyến nhanh nhất và tuyến đường 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ạ cho trường (field mask) của phản hồi bằng cách dùng tham số URL $fields hoặc fields, hoặc dùng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tiêu đề và tham số URL có sẵn. Giá trị này là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách xây dựng đường dẫn trường.

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

  • Mặt nạ trường (field mask) 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 (field mask) của tuyến đường, thời lượng, mã thông báo và thông tin thu phí: 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ạ cho trường (field mask) của phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ cho trường (field mask) ở cấp cao nhất (routes) vì:

  • Việc chỉ chọn những trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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.
  • Chỉ chọn các 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ể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn 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 sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn các trường bạn cần sẽ làm giảm kích thước phản hồi, từ đó có thông lượng mạng cao hơn.
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 Tổng quan về OAuth 2.0.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Lấy danh sách các nguồn gốc và đích đến rồi trả về một luồng chứa thông tin tuyến đường cho mỗi tổ hợp điểm xuất phát 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ạ cho trường (field mask) của phản hồi bằng cách dùng tham số URL $fields hoặc fields, hoặc dùng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tiêu đề và tham số URL có sẵn. Giá trị này là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách xây dựng đường dẫn trường.

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

  • Mặt nạ trường (field mask) 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 (field mask) của thời lượng tuyến đường, khoảng cách, trạng thái của thành phần, điều kiện và chỉ mục thành phần (ví dụ về cách thiết lập quy trình sản xuất): 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ạ cho trường (field mask) vì nếu không tất cả thông báo sẽ hiển thị là bình thường. Google không khuyến khích việc sử dụng mặt nạ cho trường phản hồi bằng ký tự đại diện (*) vì:

  • Việc chỉ chọn những trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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.
  • Chỉ chọn các 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ể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn 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 sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn các trường bạn cần sẽ làm giảm kích thước phản hồi, từ đó có thông lượng mạng cao hơn.
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 Tổng quan về OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Trả về tuyến chính cùng với các tuyến thay thế tuỳ chọn, dựa trên một tập hợp các điểm cuối và điểm tham chiếu trung gian.

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ạ cho trường (field mask) của phản hồi bằng cách dùng tham số URL $fields hoặc fields, hoặc dùng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tiêu đề và tham số URL có sẵn. Giá trị này là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách xây dựng đường dẫn trường.

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

  • Mặt nạ trường (field mask) 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 (field mask) của thời lượng, khoảng cách và nhiều đường ở cấp tuyến đường (ví dụ về cách thiết lập trong quá trình sản xuất): 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ạ cho trường (field mask) của phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ cho trường (field mask) ở cấp cao nhất (routes) vì:

  • Việc chỉ chọn những trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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.
  • Chỉ chọn các 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ể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn 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 sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn các trường bạn cần sẽ làm giảm kích thước phản hồi, từ đó có thông lượng mạng cao hơn.
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 Tổng quan về OAuth 2.0.