Tổng quan về Ma trận tuyến đường tính toán

Compute Route Matrix là một phương thức trong dịch vụ Routes API, chấp nhận yêu cầu HTTPS và trả về khoảng cách cũng như thời gian di chuyển cho một ma trận các tuyến đường giữa các vị trí xuất phát và đích đến khác nhau. Tính toán thời gian và khoảng cách di chuyển cho nhiều điểm đến với tối đa 625 phần tử tuyến đường.

Bạn cần tuyến đường lái xe? Nếu bạn quan tâm đến chỉ đường, hãy xem phần Tổng quan về Compute Routes.

Bạn có đang di chuyển không? Nếu bạn đang di chuyển từ Distance Matrix API (cũ), hãy xem hướng dẫn di chuyển bắt đầu từ Lý do nên di chuyển sang Routes API.

Lý do nên sử dụng Compute Route Matrix

Với Compute Route Matrix, bạn có thể xác định các tuyến đường hiệu quả nhất để lập lịch điều phối, chẳng hạn như:

• Cách tốt nhất để chỉ định một nhóm nhân viên đến lấy một loạt gói hàng

• Xác định kho hàng phù hợp nhất để vận chuyển các gói hàng đến điểm đến cuối cùng

Những việc bạn có thể làm với Compute Route Matrix

Với Compute Route Matrix, bạn có thể nhận được một ma trận gồm các tuyến đường có thể có giữa nhiều vị trí bắt đầu và kết thúc. Bạn có thể chỉ định nhiều điểm xuất phát và điểm đến cho mỗi yêu cầu phía máy chủ, với số lượng điểm xuất phát nhân với số lượng điểm đến tối đa là 625. Bạn có thể truyền trực tuyến các phần tử của phản hồi trước khi toàn bộ ma trận được tính toán, giảm độ trễ phản hồi.

Bạn có thể yêu cầu những loại dữ liệu về tuyến đường này để xác định cách hiệu quả nhất để định tuyến hành khách, lô hàng hoặc nhân viên giữa nhiều điểm xuất phát và điểm đến:

• Quãng đường tính bằng ki-lô-mét hoặc dặm cho một phương thức di chuyển đã chọn

• Thời gian di chuyển ước tính trong điều kiện giao thông

Cách hoạt động của Compute Route Matrix

Phương thức ComputeRouteMatrix chấp nhận yêu cầu HTTP POST có nội dung yêu cầu JSON chứa thông tin chi tiết về yêu cầu. Bạn phải có ít nhất một nguồn, hai hoặc nhiều đích đến, travelMode và một mặt nạ trường để chỉ định những trường cần trả về.

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Phản hồi chứa các tuyến đường có thể có cho tổ hợp của tất cả các điểm tham chiếu về điểm bắt đầu và điểm đến.

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua phương thức Compute Route Matrix của Routes API, cùng với dữ liệu mà phương thức này trả về.

Cách sử dụng Compute Route Matrix

Các thư viện ứng dụng hiện có

Để biết danh sách các thư viện ứng dụng hiện có cho Compute Route Matrix, hãy xem Thư viện ứng dụng.

Bước tiếp theo

• Nhận ma trận tuyến đường
• Các lựa chọn về ma trận tuyến đường hiện có
• Chọn thông tin cần trả về
• Di chuyển từ Distance Matrix API (cũ)
• Di chuyển từ bản dùng thử Routes API sang phiên bản GA