Định tuyến cho xe lớn

Định tuyến cho xe lớn là một nhóm thuộc tính cho phép bạn tối ưu hoá các tuyến đường của đội xe cho xe lớn bằng cách chỉ định kích thước vật lý, trọng lượng và số lượng xe kéo. API này sử dụng các thuộc tính này để tính toán các đường đi khả thi, tránh đường bị hạn chế, cầu thấp hoặc tuyến đường bị giới hạn trọng lượng.

Với tính năng định tuyến cho xe cỡ lớn, bạn có thể giải quyết các thách thức về hậu cần cho đội xe hạng nặng và xe cỡ lớn, ví dụ:

  • Tránh các mối nguy hiểm trên đường: Tạo kế hoạch tuyến đường để điều hướng xe tránh xa những nơi có khoảng không gian hạn chế phía trên, đường bị hạn chế trọng lượng và các mối nguy hiểm vật lý khác.
  • Chỉ định thông tin chi tiết về xe: Kết hợp kích thước chính xác, tổng trọng lượng, số lượng trục và cấu hình xe kéo vào kế hoạch tuyến đường trên toàn đội xe.
  • Cải thiện việc lập kế hoạch cho toàn bộ đội xe: Lập kế hoạch tuyến đường hiệu quả cho toàn bộ đội xe tải của bạn, đồng thời đảm bảo rằng mọi nhiệm vụ được giao đều tuân thủ các hạn chế về đường bộ.

Các điểm hạn chế

Trước khi bắt đầu, bạn phải lưu ý những hạn chế và yêu cầu sau.

  • Phạm vi cung cấp theo khu vực địa lý: Tính năng định tuyến cho xe lớn chỉ có ở 48 tiểu bang liền kề của Hoa Kỳ.
  • Cảnh báo và an toàn cho người lái xe: Người lái xe không được chỉ dựa vào các tuyến đường do API này trả về để đảm bảo an toàn hoặc hợp pháp. Chúng tôi không đảm bảo rằng các tuyến đường phù hợp với xe và việc đi theo các tuyến đường đó có thể khiến người lái xe gặp phải các mối nguy hiểm như cầu thấp hoặc đường cấm xe cỡ lớn.
  • Tuyến đường tốt nhất: Trong một số trường hợp, API không tìm được tuyến đường hoàn toàn tuân thủ các quy định hạn chế đi lại. Thay vào đó, API này trả về một tuyến đường "cố gắng hết sức" có thể vẫn đi qua các khu vực bị hạn chế.
  • Các tính năng không được hỗ trợ: Tính năng định tuyến cho xe cỡ lớn không hỗ trợ những tính năng sau:
    • Giá phí cầu đường cho xe tải
    • Giới hạn tốc độ
    • Định tuyến cho vật liệu nguy hiểm phóng xạ
  • Thanh toán: Google tính phí tất cả các yêu cầu optimizeTours một cách đồng nhất, bất kể yêu cầu có định cấu hình các thuộc tính định tuyến cho xe lớn hay không.
  • Tuyến đường dài: Tuyến đường dài dành cho xe tải có chiều dài từ 500 km trở lên cần nhiều thời gian tính toán hơn so với các tuyến đường ngắn hơn và có thể trả về dữ liệu tuyến đường có chất lượng thấp hơn. Để duy trì chất lượng tuyến đường, hãy giới hạn khoảng cách giữa các lô hàng, vị trí bắt đầu và vị trí kết thúc của xe. Nếu bạn cần các tuyến đường dài, hãy tăng thời hạn yêu cầu để giảm khả năng xảy ra lỗi DEADLINE_EXCEEDED.

Thuộc tính

Để sử dụng các thuộc tính định tuyến cho xe có kích thước lớn, bạn phải định cấu hình một chiếc xe có kích thước thực và đặt chế độ định tuyến của xe thành xe tải.

Bảng sau đây liệt kê các thuộc tính cấp cao nhất để định cấu hình hoạt động định tuyến cho xe lớn:

Thuộc tính Loại Yêu cầu Mô tả
travelMode chuỗi Bắt buộc Chỉ định chế độ di chuyển của xe. Để bật các thuộc tính định tuyến cho xe lớn, hãy đặt giá trị này thành TRUCK.
routeModifiers đối tượng Bắt buộc Chứa các cấu hình dành riêng cho tuyến đường, bao gồm cả vehicleInfo.

vehicleInfo

Đối tượng vehicleInfo chứa các thông số kỹ thuật về kích thước vật lý của xe. Hãy xác định đối tượng này trong thuộc tính routeModifiers. Bạn phải cung cấp đối tượng vehicleInfo nếu đặt travelMode thành TRUCK.

Bảng sau đây liệt kê các thuộc tính có trong đối tượng vehicleInfo:

Thuộc tính Loại Yêu cầu Mô tả
totalHeightMm số nguyên Bắt buộc Cho biết tổng chiều cao của xe tính bằng milimet. Giá trị này phải là một số nguyên dương.
totalWidthMm số nguyên Bắt buộc Cho biết tổng chiều rộng của xe tính bằng milimet. Giá trị này phải là một số nguyên dương.
totalWeightKg số nguyên Bắt buộc Cho biết tổng trọng lượng của xe theo ki-lô-gam. Giá trị này phải là một số nguyên dương.
totalLengthMm số nguyên Bắt buộc Cho biết tổng chiều dài của xe (tính bằng milimet). Giá trị này phải là một số nguyên dương.
trailerInfo mảng Không bắt buộc Chứa một mảng các thông số kỹ thuật của đoạn giới thiệu, bao gồm cả thuộc tính lengthMm để chỉ định độ dài của từng đoạn giới thiệu riêng lẻ theo milimet.
totalAxleCount số nguyên Bắt buộc Cho biết tổng số trục trên xe. Giá trị này phải là một số nguyên lớn hơn hoặc bằng 2.

Ví dụ

Phần này đề cập đến 2 loại ví dụ:

Mã mẫu

Ví dụ sau đây cho thấy cấu trúc của các thuộc tính được dùng để định tuyến xe lớn:

"vehicles": [
  {
    "travelMode": "TRUCK",
    "routeModifiers": {
      "vehicleInfo": {
        "totalHeightMm": TOTAL_HEIGHT_MM,
        "totalWidthMm": TOTAL_WIDTH_MM,
        "totalWeightKg": TOTAL_WEIGHT_KG,
        "totalLengthMm": TOTAL_LENGTH_MM,
        "trailerInfo": [
          {
            "lengthMm": TRAILER_LENGTH_MM
          }
        ],
        "totalAxleCount": TOTAL_AXLE_COUNT
      }
    }
  }
]

Ví dụ về yêu cầu

Ví dụ sau đây cho thấy cấu trúc của một yêu cầu optimizeTours cơ bản kết hợp tính năng định tuyến cho xe cỡ lớn:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 40.953523,
              "longitude": -72.2277846
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 40.9546673,
              "longitude": -72.2580151
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "TRUCK",
        "routeModifiers": {
          "vehicleInfo": {
            "totalHeightMm": 4000,
            "totalWidthMm": 2500,
            "totalWeightKg": 9000,
            "totalLengthMm": 20000,
            "trailerInfo": [
              {
                "lengthMm": 15000
              }
            ],
            "totalAxleCount": 5
          }
        },
        "costPerKilometer": 1.0
      }
    ]
  }
}