混合貨物用の車両コンパートメントを定義する

コンパートメントを使用すると、車両の貨物スペースを個別のセクションに分割し、それぞれに独立した容量を設定できるため、HERE Tour Planning APIはジョブをそれらのセクションにどのように割り当てるかを計画できます。

実際のシナリオでは、1台の車両で、同じ物理的スペースに混載できない複数の種類の貨物を運ぶことがよくあります。たとえば、食品配送トラックには、グルテンフリー製品用と通常製品用の2つの独立したコンパートメントがあり、これらは相互に悪影響を及ぼすのを防ぐために分離しておく必要があります。コンパートメント機能のおかげで、これらの各コンパートメントをそれぞれ独自の容量を持つものとしてモデル化し、さらに混載制限と組み合わせることができます。これにより、最適化アルゴリズムは車両全体を制限するのではなく、競合するジョブカテゴリーを別々のコンパートメントに配置できるようになりました。

📘

注

コンパートメントはALPHA機能です。機能の成熟度レベルの詳細については、「テスト段階の機能の詳細」を参照してください。

コンパートメント機能を有効にする

コンパートメントはテスト段階の機能です。この機能を使用するには、問題のconfigurationにあるexperimentalFeatures配列にcompartmentsを追加します。

{
  "configuration": {
    "experimentalFeatures": [
      "compartments"
    ]
  }
}

車両タイプにコンパートメントを定義する

車両を別々の貨物セクションに分割するには、capacityを使用する代わりに、fleet.types配下の対応する車両タイプにcompartments配列を追加します。配列内の各エントリーには、一意のnameと独自のcapacityが必要です。

{
  "id": "vehicle_1",
  "compartments": [
    {
      "name": "A",
      "capacity": [
        200
      ]
    },
    {
      "name": "B",
      "capacity": [
        200
      ]
    }
  ]
}
📘

注

車両タイプにはcapacityまたはcompartmentsのいずれかを設定する必要があります。両方が設定されている場合、APIはcapacityを無視します。車両全体の容量はすべてのコンパートメント容量の合計になりますが、ジョブを割り当てる際には、各コンパートメントが独自の容量制約を維持します。この原則の実例については、「個別のコンパートメント内の容量制約」の例を参照してください。

詳細については、「運行管理」を参照してください。

コンパートメント内での混載を制限する

デフォルトでは、混載制限は車両全体に適用されます。特定のコンパートメントにのみ制限を適用するには、mixingRestrictions.restrictionsの対応するエントリーにcompartments配列を追加します。これにより、APIはリストされた各コンパートメントに個別に制限を適用するため、各コンパートメントには、競合するカテゴリーのうち1つのカテゴリーのジョブのみを積載できます。

"mixingRestrictions": {
  "level": "tour",
  "restrictions": [
    {
      "compartments": [
        "A",
        "B"
      ],
      "conflictingCategories": [
        "Gluten-Free",
        "Regular"
      ]
    }
  ]
}
📘

注

コンパートメントの混載制限は、現在tourレベルでのみサポートされています。

制限エントリーにcompartmentsが指定されていない場合、その制限は車両全体に適用されます。詳しくは、「混載の制限を定義する」を参照してください。

例:個別のコンパートメント内の容量制約

このサンプルシナリオでは、車両にAとBの2つのコンパートメントがあり、それぞれの容量は5です。それぞれの需要が2の同一のジョブ5件を配送する必要があります。車両全体の容量は10 (両方のコンパートメントの合計)ですが、コンパートメント間で荷物を移動させることはできません。そのため、車両に割り当てられるジョブは4件のみ(各コンパートメントに2件ずつ)となり、容量制約のため1件のジョブは未割り当てのまま残ります。

次のセクションでは問題JSONをすべて示します。

Click to expand/collapse the sample JSON
{
  "configuration": {
    "experimentalFeatures": [
      "compartments"
    ]
  },
  "fleet": {
    "types": [
      {
        "profile": "vehicle",
        "amount": 1,
        "costs": {
          "time": 0.002,
          "distance": 0.001,
          "fixed": 10
        },
        "id": "vehicle_1",
        "shifts": [
          {
            "start": {
              "location": {
                "lat": 52.531,
                "lng": 13.38461
              },
              "time": "2026-01-16T08:00:00+01:00"
            },
            "end": {
              "location": {
                "lat": 52.531,
                "lng": 13.38461
              },
              "time": "2026-01-16T20:00:00+01:00"
            }
          }
        ],
        "compartments": [
          {
            "capacity": [
              5
            ],
            "name": "A"
          },
          {
            "capacity": [
              5
            ],
            "name": "B"
          }
        ]
      }
    ],
    "profiles": [
      {
        "name": "vehicle",
        "type": "car"
      }
    ]
  },
  "plan": {
    "jobs": [
      {
        "id": "Job_1",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.5259,
                    "lng": 13.39031
                  }
                }
              ],
              "demand": [
                2
              ]
            }
          ]
        }
      },
      {
        "id": "Job_2",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.52393,
                    "lng": 13.36127
                  }
                }
              ],
              "demand": [
                2
              ]
            }
          ]
        }
      },
      {
        "id": "Job_3",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.54179167844302,
                    "lng": 13.375259544700388
                  }
                }
              ],
              "demand": [
                2
              ]
            }
          ]
        }
      },
      {
        "id": "Job_4",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.52957449803126,
                    "lng": 13.335217684507372
                  }
                }
              ],
              "demand": [
                2
              ]
            }
          ]
        }
      },
      {
        "id": "Job_5",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.5494807231367,
                    "lng": 13.366856351494791
                  }
                }
              ],
              "demand": [
                2
              ]
            }
          ]
        }
      }
    ]
  }
}

ソリューションを解釈する

想定どおり、APIは4件のジョブを旅程に割り当て、1件のジョブは未割り当てのままにします。最適化アルゴリズムは、ジョブを両方のコンパートメントに均等に分散し、それぞれに2件ずつ割り当てます。レスポンスには、各配送アクティビティにcompartmentフィールドが含まれ、各停車地にはloadPerCompartment配列が含まれます。この配列は、旅程の進行に伴う各コンパートメントの残りの積載量を示しています。

以下のセクションでは、ソリューションの完全なJSONを示します。

Click to expand/collapse the sample JSON
{
  "statistic": {
    "cost": 26.973000000000003,
    "distance": 11249,
    "duration": 2862,
    "times": {
      "break": 0,
      "driving": 1662,
      "serving": 1200,
      "stopping": 0,
      "waiting": 0
    },
    "costs": {
      "distance": 11.249,
      "fixed": 10,
      "time": 5.724
    },
    "intraStopDistance": 0
  },
  "tours": [
    {
      "shiftIndex": 0,
      "statistic": {
        "cost": 26.973000000000003,
        "distance": 11249,
        "duration": 2862,
        "times": {
          "break": 0,
          "driving": 1662,
          "serving": 1200,
          "stopping": 0,
          "waiting": 0
        },
        "costs": {
          "distance": 11.249,
          "fixed": 10,
          "time": 5.724
        },
        "intraStopDistance": 0
      },
      "stops": [
        {
          "activities": [
            {
              "jobId": "departure",
              "type": "departure",
              "location": {
                "lat": 52.531,
                "lng": 13.38461
              },
              "time": {
                "end": "2026-01-16T07:00:00Z",
                "start": "2026-01-16T07:00:00Z",
                "arrival": "2026-01-16T07:00:00Z"
              }
            }
          ],
          "load": [
            8
          ],
          "time": {
            "arrival": "2026-01-16T07:00:00Z",
            "departure": "2026-01-16T07:00:00Z"
          },
          "distance": 0,
          "loadPerCompartment": [
            {
              "load": [
                4
              ],
              "name": "A"
            },
            {
              "load": [
                4
              ],
              "name": "B"
            }
          ],
          "location": {
            "lat": 52.531,
            "lng": 13.38461
          }
        },
        {
          "activities": [
            {
              "jobId": "Job_2",
              "type": "delivery",
              "compartment": "A",
              "location": {
                "lat": 52.52393,
                "lng": 13.36127
              },
              "time": {
                "end": "2026-01-16T07:08:38Z",
                "start": "2026-01-16T07:03:38Z",
                "arrival": "2026-01-16T07:03:38Z"
              }
            }
          ],
          "load": [
            6
          ],
          "time": {
            "arrival": "2026-01-16T07:03:38Z",
            "departure": "2026-01-16T07:08:38Z"
          },
          "distance": 1780,
          "loadPerCompartment": [
            {
              "load": [
                2
              ],
              "name": "A"
            },
            {
              "load": [
                4
              ],
              "name": "B"
            }
          ],
          "location": {
            "lat": 52.52393,
            "lng": 13.36127
          }
        },
        {
          "activities": [
            {
              "jobId": "Job_4",
              "type": "delivery",
              "compartment": "B",
              "location": {
                "lat": 52.52957449803126,
                "lng": 13.335217684507372
              },
              "time": {
                "end": "2026-01-16T07:19:40Z",
                "start": "2026-01-16T07:14:40Z",
                "arrival": "2026-01-16T07:14:40Z"
              }
            }
          ],
          "load": [
            4
          ],
          "time": {
            "arrival": "2026-01-16T07:14:40Z",
            "departure": "2026-01-16T07:19:40Z"
          },
          "distance": 4018,
          "loadPerCompartment": [
            {
              "load": [
                2
              ],
              "name": "A"
            },
            {
              "load": [
                2
              ],
              "name": "B"
            }
          ],
          "location": {
            "lat": 52.52957449803126,
            "lng": 13.335217684507372
          }
        },
        {
          "activities": [
            {
              "jobId": "Job_3",
              "type": "delivery",
              "compartment": "B",
              "location": {
                "lat": 52.54179167844302,
                "lng": 13.375259544700388
              },
              "time": {
                "end": "2026-01-16T07:33:26Z",
                "start": "2026-01-16T07:28:26Z",
                "arrival": "2026-01-16T07:28:26Z"
              }
            }
          ],
          "load": [
            2
          ],
          "time": {
            "arrival": "2026-01-16T07:28:26Z",
            "departure": "2026-01-16T07:33:26Z"
          },
          "distance": 7598,
          "loadPerCompartment": [
            {
              "load": [
                2
              ],
              "name": "A"
            },
            {
              "load": [
                0
              ],
              "name": "B"
            }
          ],
          "location": {
            "lat": 52.54179167844302,
            "lng": 13.375259544700388
          }
        },
        {
          "activities": [
            {
              "jobId": "Job_1",
              "type": "delivery",
              "compartment": "A",
              "location": {
                "lat": 52.5259,
                "lng": 13.39031
              },
              "time": {
                "end": "2026-01-16T07:44:11Z",
                "start": "2026-01-16T07:39:11Z",
                "arrival": "2026-01-16T07:39:11Z"
              }
            }
          ],
          "load": [
            0
          ],
          "time": {
            "arrival": "2026-01-16T07:39:11Z",
            "departure": "2026-01-16T07:44:11Z"
          },
          "distance": 9883,
          "loadPerCompartment": [
            {
              "load": [
                0
              ],
              "name": "A"
            },
            {
              "load": [
                0
              ],
              "name": "B"
            }
          ],
          "location": {
            "lat": 52.5259,
            "lng": 13.39031
          }
        },
        {
          "activities": [
            {
              "jobId": "arrival",
              "type": "arrival",
              "location": {
                "lat": 52.531,
                "lng": 13.38461
              },
              "time": {
                "end": "2026-01-16T07:47:42Z",
                "start": "2026-01-16T07:47:42Z",
                "arrival": "2026-01-16T07:47:42Z"
              }
            }
          ],
          "load": [
            0
          ],
          "time": {
            "arrival": "2026-01-16T07:47:42Z",
            "departure": "2026-01-16T07:47:42Z"
          },
          "distance": 11249,
          "loadPerCompartment": [
            {
              "load": [
                0
              ],
              "name": "A"
            },
            {
              "load": [
                0
              ],
              "name": "B"
            }
          ],
          "location": {
            "lat": 52.531,
            "lng": 13.38461
          }
        }
      ],
      "typeId": "vehicle_1",
      "vehicleId": "vehicle_1_1"
    }
  ],
  "unassigned": [
    {
      "jobId": "Job_5",
      "reasons": [
        {
          "code": "CAPACITY_CONSTRAINT",
          "description": "cannot be assigned due to capacity of vehicle"
        }
      ]
    }
  ]
}

例:単一配達ジョブを混載制限のある別々のコンパートメントに割り当てる

このサンプルシナリオでは、車両にAとBの2つのコンパートメントがあり、それぞれの容量は200です。tourレベルで定義された混載制限により、両方のコンパートメントには、競合するカテゴリー(Gluten-FreeとRegular)を同時に1つ以上積載することはできません。

この計画には、単一配送ジョブが2件含まれています。

  • job_1、カテゴリーGluten-Free、需要50
  • job_2、カテゴリーRegular、需要60

Gluten-FreeとRegularは競合するカテゴリーであるため、最適化アルゴリズムは両方のジョブを同じコンパートメントに割り当てることができません。そのため、ジョブをコンパートメントAとBに分散します。

次のJSONスニペットには問題の完全な仕様が含まれています。

Click to expand/collapse the sample JSON
{
  "configuration": {
    "experimentalFeatures": [
      "compartments"
    ]
  },
  "fleet": {
    "types": [
      {
        "profile": "vehicle",
        "amount": 1,
        "costs": {
          "time": 0.05,
          "distance": 0.01,
          "fixed": 100
        },
        "id": "vehicle_1",
        "shifts": [
          {
            "start": {
              "location": {
                "lat": 52.53107,
                "lng": 13.38489
              },
              "time": "2026-07-21T06:00:00Z"
            },
            "end": {
              "location": {
                "lat": 52.53107,
                "lng": 13.38489
              },
              "time": "2026-07-21T20:00:00Z"
            },
            "mixingRestrictions": {
              "level": "tour",
              "restrictions": [
                {
                  "compartments": ["A", "B"],
                  "conflictingCategories": [
                    "Gluten-Free",
                    "Regular"
                  ]
                }
              ]
            }
          }
        ],
        "compartments": [
          {
            "capacity": [
              200
            ],
            "name": "A"
          },
          {
            "capacity": [
              200
            ],
            "name": "B"
          }
        ]
      }
    ],
    "profiles": [
      {
        "name": "vehicle",
        "type": "car"
      }
    ]
  },
  "plan": {
    "jobs": [
      {
        "id": "job_1",
        "category": "Gluten-Free",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.5391496506316,
                    "lng": 13.394946372136475
                  }
                }
              ],
              "demand": [
                50
              ]
            }
          ]
        }
      },
      {
        "id": "job_2",
        "category": "Regular",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.537848867881856,
                    "lng": 13.39589059352875
                  }
                }
              ],
              "demand": [
                60
              ]
            }
          ]
        }
      }
    ]
  }
}

ソリューションを解釈する

APIは、次のソリューションに示すように、両方のジョブを同じ旅程に割り当てますが、それぞれ異なるコンパートメントに割り当てます。

Click to expand/collapse the sample JSON
  {
      "statistic": {
          "cost": 181.83999999999997,
          "distance": 3039,
          "duration": 1029,
          "times": {
              "break": 0,
              "driving": 429,
              "serving": 600,
              "stopping": 0,
              "waiting": 0
          },
          "costs": {
              "distance": 30.39,
              "fixed": 100,
              "time": 51.45
          },
          "intraStopDistance": 0
      },
      "tours": [
          {
              "shiftIndex": 0,
              "statistic": {
                  "cost": 181.83999999999997,
                  "distance": 3039,
                  "duration": 1029,
                  "times": {
                      "break": 0,
                      "driving": 429,
                      "serving": 600,
                      "stopping": 0,
                      "waiting": 0
                  },
                  "costs": {
                      "distance": 30.39,
                      "fixed": 100,
                      "time": 51.45
                  },
                  "intraStopDistance": 0
              },
              "stops": [
                  {
                      "activities": [
                          {
                              "jobId": "departure",
                              "type": "departure",
                              "location": {
                                  "lat": 52.53107,
                                  "lng": 13.38489
                              },
                              "time": {
                                  "arrival": "2026-07-21T06:00:00Z",
                                  "start": "2026-07-21T06:00:00Z",
                                  "end": "2026-07-21T06:00:00Z"
                              }
                          }
                      ],
                      "load": [
                          110
                      ],
                      "time": {
                          "arrival": "2026-07-21T06:00:00Z",
                          "departure": "2026-07-21T06:00:00Z"
                      },
                      "distance": 0,
                      "loadPerCompartment": [
                          {
                              "load": [
                                  60
                              ],
                              "name": "A"
                          },
                          {
                              "load": [
                                  50
                              ],
                              "name": "B"
                          }
                      ],
                      "location": {
                          "lat": 52.53107,
                          "lng": 13.38489
                      }
                  },
                  {
                      "activities": [
                          {
                              "jobId": "job_1",
                              "type": "delivery",
                              "compartment": "B",
                              "location": {
                                  "lat": 52.5391496506316,
                                  "lng": 13.394946372136475
                              },
                              "time": {
                                  "arrival": "2026-07-21T06:03:39Z",
                                  "start": "2026-07-21T06:03:39Z",
                                  "end": "2026-07-21T06:08:39Z"
                              }
                          }
                      ],
                      "load": [
                          60
                      ],
                      "time": {
                          "arrival": "2026-07-21T06:03:39Z",
                          "departure": "2026-07-21T06:08:39Z"
                      },
                      "distance": 1506,
                      "loadPerCompartment": [
                          {
                              "load": [
                                  60
                              ],
                              "name": "A"
                          },
                          {
                              "load": [
                                  0
                              ],
                              "name": "B"
                          }
                      ],
                      "location": {
                          "lat": 52.5391496506316,
                          "lng": 13.394946372136475
                      }
                  },
                  {
                      "activities": [
                          {
                              "jobId": "job_2",
                              "type": "delivery",
                              "compartment": "A",
                              "location": {
                                  "lat": 52.537848867881856,
                                  "lng": 13.39589059352875
                              },
                              "time": {
                                  "arrival": "2026-07-21T06:09:00Z",
                                  "start": "2026-07-21T06:09:00Z",
                                  "end": "2026-07-21T06:14:00Z"
                              }
                          }
                      ],
                      "load": [
                          0
                      ],
                      "time": {
                          "arrival": "2026-07-21T06:09:00Z",
                          "departure": "2026-07-21T06:14:00Z"
                      },
                      "distance": 1664,
                      "loadPerCompartment": [
                          {
                              "load": [
                                  0
                              ],
                              "name": "A"
                          },
                          {
                              "load": [
                                  0
                              ],
                              "name": "B"
                          }
                      ],
                      "location": {
                          "lat": 52.537848867881856,
                          "lng": 13.39589059352875
                      }
                  },
                  {
                      "activities": [
                          {
                              "jobId": "arrival",
                              "type": "arrival",
                              "location": {
                                  "lat": 52.53107,
                                  "lng": 13.38489
                              },
                              "time": {
                                  "arrival": "2026-07-21T06:17:09Z",
                                  "start": "2026-07-21T06:17:09Z",
                                  "end": "2026-07-21T06:17:09Z"
                              }
                          }
                      ],
                      "load": [
                          0
                      ],
                      "time": {
                          "arrival": "2026-07-21T06:17:09Z",
                          "departure": "2026-07-21T06:17:09Z"
                      },
                      "distance": 3039,
                      "loadPerCompartment": [
                          {
                              "load": [
                                  0
                              ],
                              "name": "A"
                          },
                          {
                              "load": [
                                  0
                              ],
                              "name": "B"
                          }
                      ],
                      "location": {
                          "lat": 52.53107,
                          "lng": 13.38489
                      }
                  }
              ],
              "typeId": "vehicle_1",
              "vehicleId": "vehicle_1_1"
          }
      ]
  }

ソリューションが示すように、出発地では両方のコンパートメントに同時に荷物が積載されます。コンパートメントAにはjob_2(カテゴリーRegular)の荷物が、コンパートメントBにはjob_1(カテゴリーGluten-Free)の荷物が積載されます。混載制限はコンパートメントAとBに個別に適用されるため、車両は旅程中に同じコンパートメントに両方のカテゴリーを積載することはできません。そのため、APIは各ジョブを異なるコンパートメントで配送するように計画します。

混載制限とコンパートメントを組み合わせた場合と、混載制限のみの場合

compartments機能を使用しない場合、混載制限は車両全体に適用されます。このシナリオでは、次の図に示すように複数の車両が必要になります(制限対象の荷物の種類ごとに個別の車両が必要)。

混載制限とコンパートメントを組み合わせた場合と、混載制限のみの場合の比較

これにより旅程の効率が低下し、1台のコンパートメント化された車両と比較して、両方の車両とも容量のごく一部しか活用できないため、総コストが増加します。

これを示すため、前の例の問題を混載制限のみを使用するように変更しました。さらに、利用可能な車両の数を1台から2台に増やしました。

Click to expand/collapse the sample JSON
{
  "fleet": {
    "types": [
      {
        "profile": "vehicle",
        "amount": 2,
        "capacity": [
          400
        ],
        "costs": {
          "time": 0.05,
          "distance": 0.01,
          "fixed": 100
        },
        "id": "vehicle_1",
        "shifts": [
          {
            "start": {
              "location": {
                "lat": 52.53107,
                "lng": 13.38489
              },
              "time": "2026-07-21T06:00:00Z"
            },
            "end": {
              "location": {
                "lat": 52.53107,
                "lng": 13.38489
              },
              "time": "2026-07-21T20:00:00Z"
            },
            "mixingRestrictions": {
              "level": "tour",
              "restrictions": [
                {
                  "conflictingCategories": [
                    "Gluten-Free",
                    "Regular"
                  ]
                }
              ]
            }
          }
        ]
      }
    ],
    "profiles": [
      {
        "name": "vehicle",
        "type": "car"
      }
    ]
  },
  "plan": {
    "jobs": [
      {
        "id": "job_1",
        "category": "Gluten-Free",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.5391496506316,
                    "lng": 13.394946372136475
                  }
                }
              ],
              "demand": [
                50
              ]
            }
          ]
        }
      },
      {
        "id": "job_2",
        "category": "Regular",
        "tasks": {
          "deliveries": [
            {
              "places": [
                {
                  "duration": 300,
                  "location": {
                    "lat": 52.537848867881856,
                    "lng": 13.39589059352875
                  }
                }
              ],
              "demand": [
                60
              ]
            }
          ]
        }
      }
    ]
  }
}

次の表は、コンパートメントがある場合とない場合のソリューションを比較しています。

コンパートメントありコンパートメントなし

コンパートメントを使用しないソリューションでは、コンパートメントを使用するソリューションと比較して、競合するカテゴリーの混載を避けるために追加の車両が必要になります(混載制限のみケースで利用可能な車両を1台に減らすと、未割り当てのジョブが発生します)。さらに、コンパートメントを使用しない場合は、旅程計画の総所要時間が長くなり、コストも大幅に増加します。

結論

  • 車両タイプのcompartmentsプロパティを使用すると、1つの共有容量ではなく、サイズが個別に設定された複数の貨物セクションを持つ車両をモデル化できます。
  • mixingRestrictionsエントリーにcompartments配列を追加すると、その制限はリストされた各コンパートメントに個別に適用されます。そのため、互換性のないジョブカテゴリーでも、異なるコンパートメントに配置されていれば同じ車両で運搬することが可能です。
  • mixingRestrictionsエントリーにcompartmentsが指定されていない場合、その制限は引き続き車両全体に適用されます。

次のステップ

  • 個々のコンパートメントではなく車両全体に制限を適用する方法については、「混載の制限を定義する」を参照してください。
  • HERE Tour Planning APIで問題を作成する方法の詳細については、「問題」を参照してください。
  • HERE Tour Planning APIのメソッド、エンドポイント、パラメーターの詳細については、「APIリファレンス」を参照してください。

このページは役に立ちましたか?