Tính toán ma trận tuyến đường

Bạn có thể tính toán khoảng cách và thời gian của một tuyến đường cho nhiều điểm xuất phát và điểm đến bằng cách sử dụng phương thức ComputeRouteMatrix của Routes Preferred API. ComputeRouteMatrix hỗ trợ cả lệnh gọi gRPC truyền trực tuyến và lệnh gọi HTTP REST.

Dựa trên danh sách các cặp điểm xuất phát và điểm đến, ComputeRouteMatrix sẽ tính toán khoảng cách và thời gian của một tuyến đường bắt đầu tại mỗi điểm xuất phát và kết thúc tại mỗi điểm đến. Mỗi phần tử của luồng tương ứng với thông tin của một tuyến đường.

Phương thức ComputeRouteMatrix có một số ưu điểm so với Distance Matrix API (Cũ):

  • Tính năng truyền trực tuyến cho phép trả về các phần tử trước khi toàn bộ ma trận được tính toán, giúp giảm độ trễ.
  • ComputeRouteMatrix có các lựa chọn chi tiết để tính toán lưu lượng truy cập, giúp bạn đưa ra quyết định đánh đổi giữa chất lượng và độ trễ.
  • Các yêu cầu được chạy ở mức độ ưu tiên cao hơn trong cơ sở hạ tầng của Google, nhờ đó có khả năng đáp ứng cao hơn.
  • Bạn có thể chỉ định thông tin về hướng (hướng di chuyển) và bên đường cho các điểm tham chiếu.
  • Bạn có thể yêu cầu trả về thông tin phí cầu đường, cùng với khoảng cách tuyến đường và thời gian đến dự kiến.

Bật phương thức ComputeRouteMatrix

Trước khi có thể sử dụng phương thức ComputeRouteMatrix 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 ComputeRouteMatrix

Bạn có thể sử dụng phương thức ComputeRouteMatrix thông qua điểm cuối v1 của Routes Preferred.

Hãy xem tài liệu sau để biết thêm thông tin chi tiết:

gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

Các bước chung sau đây mô tả cách sử dụng gRPC để gọi phương thức ComputeRouteMatrix:

  1. Kiểm tra các vùng đệm giao thức cần thiết từ kho lưu trữ googleapis:

    https://github.com/googleapis/googleapis/tree/master/google/maps/routes

    Xin lưu ý rằng một số hệ thống xây dựng (chẳng hạn như Go) có thể tự động thực hiện việc này cho bạn.

  2. Sử dụng ngôn ngữ và bộ công cụ xây dựng mà bạn ưu tiên để tạo mã bộ đệm giao thức liên quan.

  3. Tạo yêu cầu. Bạn phải gửi hai phần siêu dữ liệu bắt buộc cùng với yêu cầu:

    • Bạn phải đặt X-Goog-Api-Key thành khoá API của mình.

    • Bạn phải đặt X-Goog-Fieldmask thành danh sách các trường được phân tách bằng dấu phẩy mà bạn cần trong phản hồi. Ví dụ: X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status. Bạn có thể sử dụng ký tự đại diện (*) để biểu thị tất cả các trường, nhưng bạn không nên làm như vậy. Sử dụng ký tự đại diện để kiểm thử và tìm hiểu phản hồi của API, nhưng hãy liệt kê rõ ràng các trường bạn muốn trong mặt nạ trường trong mã phát hành công khai.

      Để biết thêm thông tin về cách tạo chuỗi mặt nạ trường, hãy xem https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto. Xin lưu ý rằng việc tắt các trường bạn không cần có thể làm giảm độ trễ vì các trường đó có thể cần tính toán thêm. Độ trễ của bạn sẽ duy trì ổn định nếu bạn chỉ định các trường cần thiết và các trường mới yêu cầu nhiều phép tính hơn sẽ được thêm vào sau.

  4. Gửi yêu cầu của bạn đến routespreferred.googleapis.com:443.Bạn phải sử dụng giao thức TLS.

Để biết ví dụ về cách sử dụng phương thức ComputeRouteMatrix, hãy xem phần Ví dụ về cách tính toán ma trận tuyến đường (Thử nghiệm).

Một tính năng nổi bật của phương thức ComputeRouteMatrix là mã lỗi có thể được trả về cho toàn bộ luồng hoặc cho từng phần tử. Ví dụ: kết nối luồng sẽ trả về lỗi nếu yêu cầu không đúng định dạng (ví dụ: không có nguồn gốc). Tuy nhiên, nếu lỗi chỉ áp dụng cho một vài phần tử của luồng (ví dụ: đặt Mã địa điểm không hợp lệ cho điểm xuất phát), thì chỉ những phần tử chịu ảnh hưởng của lỗi mới chứa mã lỗi.

Các phần tử do luồng trả về không được đảm bảo sẽ được trả về theo bất kỳ thứ tự nào. Do đó, mỗi phần tử chứa một origin_index và một destination_index. Đối với các điểm xuất phát và điểm đến được chỉ định theo yêu cầu, điểm xuất phát của tuyến đường tương đương với origins[origin_index] cho một phần tử nhất định và điểm đến của tuyến đường tương đương với destinations[destination_index]. Các mảng này được lập chỉ mục từ 0. Bạn cần lưu trữ thứ tự danh sách nguồn và đích.

Đ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 ma trận tuyến đường.