Bạn có thể tính khoảng cách và thời lượng của một tuyến cho nhiều nguồn gốc và đích đến bằng cách sử dụng phương thức ComputeRouteMatrix của API Ưu tiên tuyến. ComputeRouteMatrix hỗ trợ cả lệnh gọi gRPC truyền trực tuyến và lệnh gọi HTTP REST.
Với danh sách các cặp nguồn gốc và đích đến, ComputeRouteMatrix sẽ tính toán khoảng cách và thời lượng của một tuyến đường bắt đầu tại mỗi điểm gốc và kết thúc tại mỗi đích đến. Mỗi phần tử của luồng tương ứng với thông tin của một tuyến duy nhất.
Phương thức ComputeRouteMatrix có một số ưu điểm so với Dịch vụ ma trận khoảng cách:
- Tính năng truyền trực tuyến cho phép trả về các phần tử trước khi tính toán toàn bộ ma trận, giúp giảm độ trễ.
ComputeRouteMatrixcó các tuỳ chọn chi tiết để tính toán lưu lượng truy cập, cho phép bạn đưa ra các quyết định đánh đổi độ trễ về chất lượng.- 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, dẫn đến khả năng đáp ứng cao hơn.
- Bạn có thể chỉ định hướng (hướng đi) và thông tin bên đường cho các điểm tham chiếu.
- Bạn có thể yêu cầu hệ thống trả lại thông tin phí cầu đường, cùng với khoảng cách tuyến đường và giờ đến dự kiến.
Bật phương thức ComputeRouteMatrix
Để có thể sử dụng phương thức ComputeRouteMatrix 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 ComputeRouteMatrix
Phương thức ComputeRouteMatrix có sẵn thông qua điểm cuối v1 của Tuyến đường ưu tiên.
Hãy xem tài liệu sau để biết thêm thông tin chi tiết:
Kiến trúc chuyển trạng thái đại diện (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:
Xem các protobuffers cần thiết trong 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 làm việc này cho bạn.
Bằng ngôn ngữ và bộ công cụ xây dựng mà bạn ưu tiên, hãy tạo mã protobuffer phù hợp.
Tạo yêu cầu. 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.
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 gồm các trường mà bạn yêu cầu 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. Hãy sử dụng ký tự đại diện để kiểm tra và 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 (field mask) trong mã phát hành chính thức.
Để 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. Lưu ý rằng việc tắt các trường không cần thiết có thể giúp giảm độ trễ vì các trường đó có thể cần phải tính toán thêm. Độ trễ của bạn sẽ vẫn ổn định nếu bạn chỉ định các trường cần thiết và các trường mới cần phải tính toán thêm sẽ được thêm vào sau này.
Gửi yêu cầu của bạn tới
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 Ví dụ về tính toán ma trận tuyến (Beta).
Một đặc điểm phân biệt của phương thức ComputeRouteMatrix là hệ thống có thể trả về mã lỗi 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ề một lỗi nếu yêu cầu không đúng định dạng (ví dụ: yêu cầu 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 một điểm gốc), 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 gốc và đích đến được chỉ định theo yêu cầu, gốc của tuyến tương đương với origins[origin_index] đối với một phần tử nhất định và đích đến của tuyến tương đương với destinations[destination_index]. Các mảng này được lập chỉ mục bằng 0. Bạn cần phải lưu trữ các đơn đặt hàng trong danh sách điểm khởi hành và điểm đến.
Đ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ề tính toán ma trận tuyến đường.