Hindari putar balik

Penghindaran putar balik adalah fitur pengoptimalan rute yang mencegah kendaraan berputar balik di lokasi penjemputan atau pengiriman tertentu dalam kunjungan. Dengan menetapkan penghindaran putar balik, Anda menentukan bahwa kendaraan harus menghadap ke arah yang sama saat tiba dan saat meninggalkan lokasi kunjungan.

Penghindaran putar balik berfungsi dengan cara berikut:

1. Anda menetapkan properti penghindaran putar balik di kunjungan tertentu.
2. API ini mempertimbangkan kedua arah perjalanan di jalan dua arah dan memilih jalur yang paling optimal.
3. API membuat rute saat kendaraan tiba dan berangkat tanpa berbelok di lokasi kunjungan. Pengemudi mungkin perlu menyeberang jalan untuk mencapai lokasi ini.

Properti ini ideal untuk situasi ketika berbelok U sulit atau tidak mungkin dilakukan karena ukuran kendaraan, rambu lalu lintas, atau kondisi lalu lintas yang biasa.

Properti

Properti penghindaran putar balik ditentukan dalam objek VisitRequest. Objek ini digunakan di dalam array pickups dan deliveries dari pengiriman.

Contoh

Bagian ini membahas dua jenis contoh:

• Contoh kode yang mengilustrasikan struktur penghindaran belokan U.
• Contoh permintaan yang menyertakan fitur.

Contoh kode

Contoh berikut menunjukkan strukturavoidUTurns dalam pengambilan dan pengiriman:

"pickups":[
  {
    "arrivalLocation": {
      "latitude": 37.42506261000996,
      "longitude": -122.09535511930135
    },
    "avoidUTurns": true
  }
],
"deliveries":[
  {
    "arrivalLocation": {
      "latitude": 37.42421503206021,
      "longitude": -122.09526063135228
    },
    "avoidUTurns": true
  }
]

Contoh permintaan

Contoh berikut menunjukkan permintaan optimizeTours dasar yang menggabungkan penghindaran belokan U. Permintaan ini mencakup elemen berikut:

• Pengiriman dengan pengambilan dan pengantaran di dalam objek model.
• Properti avoidUTurns ditetapkan ke true di lokasi pengambilan dan pengiriman untuk mencegah kendaraan mengubah arah di perhentian tersebut.

  {
    "model": {
      "shipments":[
        {
          "pickups":[
            {
              "arrivalLocation": {
                "latitude": 37.42506261000996,
                "longitude": -122.09535511930135
              },
              "avoidUTurns": true
            }
          ],
          "deliveries":[
            {
              "arrivalLocation": {
                "latitude": 37.42421503206021,
                "longitude": -122.09526063135228
              },
              "avoidUTurns": true
            }
          ]
        }
      ],
      "vehicles":[
        {
          "travelMode": "DRIVING",
          "costPerKilometer": 1.0
        }
      ]
    }
  }

Menghindari putar balik dengan sideOfRoad

Meskipun sideOfRoad adalah fitur terpisah, fitur ini terkait erat dengan penghindaran belokan U karena mencegah banyak belokan U dengan mengarahkan kendaraan ke sisi jalan yang paling dekat dengan tujuan. Hal ini memaksa kendaraan untuk mendekati lokasi kunjungan dari arah tertentu, sehingga tidak perlu berputar balik.

Dalam praktiknya, Anda harus menggunakan penghindaran putar balik jika aman untuk menyeberang jalan dengan berjalan kaki untuk menuju lokasi kunjungan. Jika menyeberang jalan tidak disarankan atau tidak memungkinkan, sebaiknya tetapkan sideOfRoad ke true.

Properti sideOfRoad ditentukan dalam objek Waypoint.

Interaksi dengan fitur lain

Penghindaran belokan U berinteraksi dengan fitur perutean lainnya dengan cara berikut:

• Pinggir jalan: Menyetel avoidUTurns dan sideOfRoad ke true sedikit meningkatkan peluang untuk menghindari putar balik saat merutekan kendaraan ke pinggir jalan yang paling dekat dengan lokasi kunjungan. Namun, tindakan ini menimbulkan kompleksitas tambahan terkait pembatasan penghindaran putar balik. Untuk sebagian besar lokasi kunjungan, menetapkan hanya satu properti ini sudah cukup untuk menghindari putar balik.
• Solusi yang dimasukkan: Saat Anda menggunakan penghindaran putar balik, respons API akan menyertakan injectedSolutionLocationToken di dalam ShipmentRoute.Visit yang dihasilkan untuk mencatat sisi jalan yang dipilih. Jika Anda menggunakan kembali kunjungan ini sebagai solusi yang disisipkan dalam permintaan mendatang, Anda harus meneruskan kembali token ini ke API.

Batasan

Penghindaran putar balik adalah fitur upaya terbaik. API mungkin masih menyertakan putar balik dalam rute yang dihasilkan dalam kondisi berikut:

• Mode perjalanan disetel ke mode selain DRIVING.
• Lokasi kedatangan dan keberangkatan untuk lokasi kunjungan tertentu berbeda. Dalam hal ini, API akan menampilkan error.
• Kunjungan berada di jalan buntu, sehingga memerlukan putar balik untuk keluar.
• Putar balik terjadi di sepanjang rute, bukan di lokasi kunjungan sebenarnya.
• Manuver ini adalah belokan tajam ke jalan lain, yang tidak diklasifikasikan sebagai putar balik oleh API.