Perutean kendaraan besar

Perutean kendaraan besar adalah serangkaian properti yang memungkinkan Anda mengoptimalkan rute armada untuk kendaraan besar dengan menentukan dimensi fisik, berat, dan jumlah trailer. API menggunakan atribut ini untuk menghitung jalur yang layak yang menghindari jalan terlarang, jembatan rendah, atau rute dengan batasan berat.

Dengan perutean kendaraan besar, Anda dapat mengatasi tantangan logistik armada untuk kendaraan berat dan besar, misalnya:

  • Menghindari bahaya di jalan: Membuat rencana rute yang mengarahkan kendaraan menjauhi ruang bebas vertikal rendah, jalan dengan batasan berat, dan bahaya fisik lainnya.
  • Tentukan informasi kendaraan yang mendetail: Gabungkan dimensi yang akurat, total berat, jumlah gandar, dan konfigurasi trailer ke dalam rencana rute seluruh armada.
  • Meningkatkan perencanaan di seluruh armada: Buat rencana rute yang efisien untuk seluruh armada truk Anda sekaligus memastikan bahwa semua tugas mematuhi batasan jalan fisik.

Batasan

Sebelum memulai, Anda harus mengetahui batasan dan persyaratan berikut.

  • Ketersediaan geografis: Perutean kendaraan besar hanya tersedia di 48 negara bagian Amerika Serikat yang berdekatan.
  • Saran dan keselamatan pengemudi: Pengemudi tidak boleh hanya mengandalkan rute yang ditampilkan oleh API ini agar aman atau sesuai hukum. Rute tidak dijamin sesuai untuk kendaraan, dan mengikutinya dapat membuat pengemudi terpapar bahaya seperti jembatan rendah atau jalan yang melarang kendaraan besar.
  • Rute upaya terbaik: Dalam beberapa kasus, API tidak dapat menemukan rute yang sepenuhnya mematuhi pembatasan perjalanan. Sebagai gantinya, rute "upaya terbaik" yang mungkin masih melintasi area terlarang akan ditampilkan.
  • Fitur yang tidak didukung: Perutean kendaraan besar tidak mendukung hal berikut:
    • Harga tol truk
    • Batas kecepatan
    • Rute untuk bahan berbahaya radioaktif
  • Penagihan: Google menagih semua permintaan optimizeTours secara seragam, terlepas dari apakah permintaan tersebut mengonfigurasi properti perutean kendaraan besar.
  • Rute jarak jauh: Rute truk jarak jauh yang mencakup 500 kilometer atau lebih memerlukan waktu komputasi yang lebih lama daripada rute yang lebih pendek, dan mungkin menampilkan data rute yang berkualitas lebih rendah. Untuk menjaga kualitas rute, batasi jarak antara pengiriman, lokasi awal kendaraan, dan lokasi akhir kendaraan. Jika Anda memerlukan rute yang panjang, perpanjang batas waktu permintaan untuk mengurangi kemungkinan terjadinya error DEADLINE_EXCEEDED.

Properti

Untuk menggunakan properti perutean kendaraan besar, Anda harus mengonfigurasi kendaraan dengan dimensi fisiknya dan menyetel mode peruteannya ke truk.

Tabel berikut mencantumkan properti tingkat teratas untuk mengonfigurasi perutean kendaraan besar:

Properti Jenis Persyaratan Deskripsi
travelMode string Wajib Menentukan mode perjalanan untuk kendaraan. Untuk mengaktifkan properti perutean kendaraan besar, tetapkan nilai ini ke TRUCK.
routeModifiers objek Wajib Berisi konfigurasi khusus rute, termasuk vehicleInfo.

vehicleInfo

Objek vehicleInfo berisi spesifikasi fisik kendaraan. Tentukan objek ini dalam properti routeModifiers. Objek vehicleInfo harus disediakan jika Anda menetapkan travelMode ke TRUCK.

Tabel berikut mencantumkan properti yang tersedia dalam objek vehicleInfo:

Properti Jenis Persyaratan Deskripsi
totalHeightMm bilangan bulat Wajib Menentukan total tinggi kendaraan dalam milimeter. Nilai ini harus berupa bilangan bulat positif.
totalWidthMm bilangan bulat Wajib Menentukan lebar total kendaraan dalam milimeter. Nilai ini harus berupa bilangan bulat positif.
totalWeightKg bilangan bulat Wajib Menentukan total berat kendaraan dalam kilogram. Nilai ini harus berupa bilangan bulat positif.
totalLengthMm bilangan bulat Wajib Menentukan panjang total kendaraan dalam milimeter. Nilai ini harus berupa bilangan bulat positif.
trailerInfo array Opsional Berisi array spesifikasi trailer, yang mencakup properti lengthMm untuk menentukan panjang setiap trailer dalam milimeter.
totalAxleCount bilangan bulat Wajib Menentukan jumlah total gandar pada kendaraan. Nilai ini harus berupa bilangan bulat yang lebih besar dari atau sama dengan 2.

Contoh

Bagian ini mencakup dua jenis contoh:

Contoh kode

Contoh berikut menunjukkan struktur properti yang digunakan untuk perutean kendaraan besar:

"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
      }
    }
  }
]

Contoh permintaan

Contoh berikut menunjukkan struktur permintaan optimizeTours dasar yang menggabungkan perutean kendaraan besar:

{
  "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
      }
    ]
  }
}