メインコンテンツまでスキップ

Logistics API 設定

simulation.data.logistics_api_settings オブジェクトを使用すると、Stateful API を使用してシミュレーションを実行する際の最適化プロセスを微調整できます。これらの設定は、ソルバー、モデル制約、および計算動作のさまざまな側面を制御します。

一般設定 (General Settings)​

これらの設定は、物流シミュレーション構成に直接適用されます。

パラメータ型説明デフォルト
pipeline_typestring計算パイプラインを定義します。simple_one_stage: 単一のステートレスAPI呼び出し。two_stages: 推定とそれに続く正確な計算。-
first_solution_strategiesarray最適化実行を同時に実行するために使用される初期解戦略（整数）のリスト。-
only_pdpbooleantrue の場合、Pickup and Delivery Problem (PDP) モードのみを使用します。false の場合、デフォルトで CVRPTW になります。-
trip_costnumber各トリップに割り当てられるコスト。-
max_pickup_slackinteger集荷ノードの最大許容スラック時間（秒単位）。-
max_dropoff_slackinteger降車ノードの最大許容スラック時間（秒単位）。-
use_path_equalizerboolean車両間での割り当てをより均等に分散するために Path Equalizer を有効にします。-
path_equalizer_weightintegerPath Equalizer 目的関数の重み。-
average_travel_duration_to_nodeintegerノードへの推定平均移動時間（秒単位）。-
allow_upload_after_simulation_start_timebooleantrue の場合、シミュレーション開始後の予約更新（例：ライブ挿入）を許可します。false
should_set_max_slack_start_location_zeroboolean開始位置の最大スラックをゼロに設定するかどうか。-
is_pickup_end_of_tripbooleantrue の場合、集荷ノードをトリップの終了として扱います（トリップ数制約のため）。-
is_dropoff_end_of_tripbooleantrue の場合、降車ノードをトリップの終了として扱います（トリップ数制約のため）。-
stateless_api_serverstringシミュレーションに使用するカスタムステートレスAPIサーバーのURL。-
should_lock_next_stop_if_vehicle_liveboolean再最適化中のドライバーの混乱を防ぐため、ライブ車両の次の停車地をロックします。true
should_optimize_fail_to_board_bookingsbooleantrue の場合、ピックアップに失敗した注文を最適化の試行に含めます。true
truckban_enabledbooleanトラック規制（Truck Ban）制約を有効または無効にします。-
truckban_buffer_time_windowsintegerトラック規制のために時間枠を調整する際のバッファ時間（秒単位）。-
slack_costnumberすべてのノードのスラック時間に適用されるコスト。-
logistics_optimize_slackbooleantrue の場合、ソルバーは物流モードでスラックを最適化します。-
path_constraints_modestringパス制約のモード。-
node_grouping_enabledbooleanノードグループ化ロジックを有効にします。-
clear_cumulative_limitationsbooleantrue に設定すると、累積制限をクリアします。-
manual_edit_api_minimize_slackboolean手動編集API操作中にスラックを最小化しようとします。-
manual_edit_allow_vehicle_lateboolean手動編集中の車両の遅延を許可します。true
manual_edit_lateness_penalty_coefficientinteger手動編集における遅延のペナルティ係数。10
cvb_fleetmin_time_limitintegerCVBフリート最小化の時間制限。-
cvb_fleetmin_solutions_limitintegerCVBフリート最小化のソリューション制限。-
cvb_fleetmin_iterations_limitintegerCVBフリート最小化の反復制限。-
use_cvb_local_search_operatorbooleanCVBローカル検索オペレーターを使用します。-
cvb_local_search_iterations_limitintegerCVBローカル検索の反復制限。-
geofence_definition_strategyobjectジオフェンスを定義するための戦略。-
geofence_vehicle_allocation_strategyobject車両をジオフェンスに割り当てるための戦略（STRICT または FLEXIBLE）。-
stateless_api_loginstringカスタムステートレスAPIサーバーのログイン。-
stateless_api_passwordstringカスタムステートレスAPIサーバーのパスワード。-
truckban_strategyobjectトラック規制を処理するための戦略。-
booking_order_prioritizationobject予約順序の優先順位付けの設定。-
node_grouping_capacity_strategyobjectノードグループ化容量要件の戦略。-
manual_edit_api_vehicle_logistics_optimize_slackboolean手動編集APIがスラックを最適化すべきかどうか。-
manual_edit_api_use_vehicle_start_timeboolean手動編集に車両の開始時間を使用します。-
manual_edit_api_solver_kindstring手動編集APIのソルバーの種類（デフォルト：LOCAL）。LOCAL
manual_edit_finalization_type_pickupsstring手動編集における集荷ノードの確定タイプ。-
manual_edit_finalization_type_dropoffsstring手動編集における降車ノードの確定タイプ。-
manual_edit_max_possible_latenessinteger手動編集における最大許容遅延。-
manual_edit_optimize_quantitystring手動編集の最適化量。-
manual_edit_slack_cost_factornumber手動編集のスラックコスト係数。-
route_cost_modification_primaryobjectプライマリルーティングエンジンのルートコスト修正。-
route_cost_modification_secondaryobjectセカンダリルーティングエンジンのルートコスト修正。-

ソルバーパラメータ (Solver Parameters)​

これらのパラメータは、基礎となるVRPソルバーの動作を制御します。これらは通常、専門家がパフォーマンスを調整するために使用します。

パラメータ型説明デフォルト
algorithmstringソルバーアルゴリズム: static (デフォルト) または dynamic (リアルタイム/オンデマンド用)。static
first_solution_strategyinteger初期解を見つけるために使用される戦略。0
solution_limitnumber検索中に生成するソリューションの最大数。10000000
time_limit_msnumber検索に許可される最大時間（ミリ秒単位）。10000000
use_local_search_metaheuristicbooleanローカル検索メタヒューリスティクスを有効にします。false
guided_local_search_lambda_coefficientnumberガイド付きローカル検索手順のパラメータ。0.1
use_tsp_optboolean巡回セールスマン問題 (TSP) 最適化を有効にします。false
log_searchboolean検索ログを有効にします。false
lns_time_limit_msnumber大規模近傍探索 (LNS) 完了検索の時間制限。1000
savings_neighbors_rationumber節約法の近傍比率。0
waypoints_optimization_second_phasebooleanprebook モードのウェイポイント最適化の第2フェーズを有効にします。false
optimization_stepnumberローカル検索の最小改善ステップ。1
use_all_local_search_operatorsboolean利用可能なすべてのローカル検索オペレーターを使用します。false
use_depth_first_searchbooleanローカル検索の代わりに深さ優先探索を使用します。false

モデルパラメータ (Model Parameters)​

これらのパラメータは、シミュレーションモデルの一般的なメタデータと制約を定義します。

パラメータ型説明デフォルト
vehicle_costsnumber車両ごとのコスト。コストが高いと、追加車両の使用が抑制される可能性があります。0
booking_penaltynumber訪問の取りこぼし（未提供の予約）に対するペナルティ。目的関数に追加されます。10000
mixed_fleetboolean車両が異なるルーティングプロファイルを使用する場合に true に設定します。false
use_walking_time_to_reduce_time_windowsboolean時間枠を調整するために徒歩時間を使用します。false
time_dependent_transitbooleantrue の場合、最適化の目標は常に total_distance になります。false
optimize_quantitystring最適化の目標: total_time (デフォルト) または total_distance。total_time
max_slacknumber最大許容スラック（秒単位）。null
use_lifo_order_checkbooleanLIFO (後入れ先出し) 順序制約を有効にします。false
lifo_order_check_on_all_vehiclesbooleanすべての車両にLIFOチェックを適用します。true
group_crossing_penaltynumber厳密に排他的でないグループの交差に対するペナルティ。-
strictly_exclusive_groupsarray同じ車両に混在できないグループのリスト。-
mutually_exclusive_groupsarray相互に排他的なグループペアのリスト（ソフトまたはハード制約）。-
compound_zonesarray入退場時間ペナルティを伴うゾーンの定義。-
cumulative_limitationsarrayデポで同時にサービスを受ける車両数の制限。-
route_compactnessobjectポリリニアコストモデルを使用してルートのコンパクトさを強制する設定。-
vehicle_amortized_linear_cost_factorinteger償却デフォルト車両コストの線形部分。-
vehicle_amortized_quadratic_cost_factorinteger償却デフォルト車両コストの二次部分。-
groups_orderobjectグループの順序/優先順位を定義する辞書。-

計算パラメータ (Calculation Parameters)​

これらのパラメータは、計算の実行方法と制約の処理方法を制御します。

パラメータ型説明デフォルト
scheduling_modestringprebook (PDP) または prebook_cvrptw (CVRPTW)。CVRPTW は単一の集荷/DCシナリオ用です。-
calculations_modestringsync (結果を即座に返す) または async (ジョブIDを返す)。-
use_vehicles_nodesboolean車両を表すノードの使用を有効または無効にします。-
allow_vehicle_latebooleanより良いルートのために、時間制約を緩和して遅延到着を許可します。false
vehicle_late_penalty_coefficientintegerallow_vehicle_late が true の場合の遅延に対するペナルティの重み。-
max_possible_latenessinteger最大許容遅延（秒単位）。null
dropoff_earlierbooleantrue の場合、ループを避けるために降車を早めにスケジュールしようとします。false
pickup_laterbooleantrue の場合、ループを避けるために集荷を遅めにスケジュールしようとします。false
に最終更新