ShipmentModel

出荷モデルには、車両のセットで実施する必要がある一連の出荷が含まれ、次の合計値となる総コストが最小限に抑えられます。

  • 車両のルーティング費用(合計時間あたりの費用、移動時間あたりの費用、すべての車両の固定費用の合計)。
  • 未履行配送ペナルティが科されます
  • 配送のグローバル期間の費用
JSON 表現
{
  "shipments": [
    {
      object (Shipment)
    }
  ],
  "vehicles": [
    {
      object (Vehicle)
    }
  ],
  "globalStartTime": string,
  "globalEndTime": string,
  "globalDurationCostPerHour": number,
  "durationDistanceMatrices": [
    {
      object (DurationDistanceMatrix)
    }
  ],
  "durationDistanceMatrixSrcTags": [
    string
  ],
  "durationDistanceMatrixDstTags": [
    string
  ],
  "transitionAttributes": [
    {
      object (TransitionAttributes)
    }
  ],
  "shipmentTypeIncompatibilities": [
    {
      object (ShipmentTypeIncompatibility)
    }
  ],
  "shipmentTypeRequirements": [
    {
      object (ShipmentTypeRequirement)
    }
  ],
  "precedenceRules": [
    {
      object (PrecedenceRule)
    }
  ],
  "maxActiveVehicles": integer
}
フィールド
shipments[]

object (Shipment)

モデルで実行する必要がある配送セット。

vehicles[]

object (Vehicle)

訪問に使用できる車両のセット。

globalStartTime

string (Timestamp format)

モデルのグローバルな開始時間と終了時間: この範囲外の時刻は有効と見なされません。

モデルの時間範囲は 1 年未満にする必要があります。つまり、globalEndTimeglobalStartTime は 31,536,000 秒以内にする必要があります。

cost_per_*hour フィールドを使用するときは、パフォーマンスを向上させるために、この時間枠を短い間隔に設定することをおすすめします(たとえば、1 日をモデル化する場合は、グローバルな時間制限をその日に設定する必要があります)。設定しない場合、1970 年 1 月 1 日 00:00:00 UTC(つまり、秒: 0、nanos: 0)がデフォルトで使用されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

globalEndTime

string (Timestamp format)

設定しない場合、1971 年 1 月 1 日 00:00:00 UTC(秒: 31536000、nanos: 0)がデフォルトで使用されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

globalDurationCostPerHour

number

全体的なプランの「グローバルな期間」は、すべての車両の有効な開始時間の最も早い時間と有効な終了時間の最も遅い時間の差です。ユーザーは、その数量に 1 時間あたりの費用を割り当てることで、たとえばジョブの完了を最短にするように最適化できます。この費用は Shipment.penalty_cost と同じ単位にする必要があります。

durationDistanceMatrices[]

object (DurationDistanceMatrix)

モデルで使用する期間行列と距離行列を指定します。このフィールドが空の場合、useGeodesicDistances フィールドの値に応じて、Google マップまたは測地線距離が代わりに使用されます。空でない場合、useGeodesicDistances を true にすることはできません。また、durationDistanceMatrixSrcTagsdurationDistanceMatrixDstTags も空にすることはできません。

使用例:

  • locA と locB の 2 つの場所があります。
  • 1 台の車両が locA でルートを開始し、locA で終了しています。
  • locB での集荷訪問リクエスト 1 件。
model {
  vehicles { startTags: "locA"  endTags: "locA" }
  shipments { pickups { tags: "locB" } }
  durationDistanceMatrixSrcTags: "locA"
  durationDistanceMatrixSrcTags: "locB"
  durationDistanceMatrixDstTags: "locA"
  durationDistanceMatrixDstTags: "locB"
  durationDistanceMatrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}
  • locA、locB、locC の 3 つの場所があります。
  • 1 台の車両が locA から locB までルートを走行し、マトリックス「fast」を使用します。
  • 1 台の車両が、「slow」という行列を使用して、locB でルートを開始し、locB で終了しています。
  • 1 台の車両が locB でルートを開始し、locB で終了し、マトリックス「fast」を使用します。
  • locC で 1 件の集荷訪問リクエスト。
model {
  vehicles { startTags: "locA" endTags: "locB" startTags: "fast" }
  vehicles { startTags: "locB" endTags: "locB" startTags: "slow" }
  vehicles { startTags: "locB" endTags: "locB" startTags: "fast" }
  shipments { pickups { tags: "locC" } }
  durationDistanceMatrixSrcTags: "locA"
  durationDistanceMatrixSrcTags: "locB"
  durationDistanceMatrixSrcTags: "locC"
  durationDistanceMatrixDstTags: "locB"
  durationDistanceMatrixDstTags: "locC"
  durationDistanceMatrices {
    vehicleStartTag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  durationDistanceMatrices {
    vehicleStartTag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}
durationDistanceMatrixSrcTags[]

string

滞在時間および距離行列のソースを定義するタグです。durationDistanceMatrices(i).rows(j) は、durationDistanceMatrixSrcTags(j) タグが付けられた訪問から、行列 i の他の訪問までの滞在時間と距離を定義します。

タグは VisitRequest.tags または Vehicle.start_tags に対応します。指定された VisitRequest または Vehicle は、このフィールドの 1 つのタグだけと一致する必要があります。Vehicle のソースタグ、宛先タグ、マトリックス タグは同じになる場合があります。同様に、VisitRequest のソースタグと宛先タグも同じになる場合があります。タグはすべて異なっている必要があり、空の文字列にすることはできません。このフィールドが空でない場合、durationDistanceMatrices を空にすることはできません。

durationDistanceMatrixDstTags[]

string

所要時間と距離のマトリックスの宛先を定義するタグ。durationDistanceMatrices(i).rows(j).durations(k)durationDistanceMatrices(i).rows(j).meters(k)) は、タグ durationDistanceMatrixSrcTags(j) の訪問からタグ durationDistanceMatrixDstTags(k) の訪問までの移動時間(または距離)を定義します。

タグは VisitRequest.tags または Vehicle.start_tags に対応します。指定された VisitRequest または Vehicle は、このフィールドの 1 つのタグだけと一致する必要があります。Vehicle のソースタグ、デスティネーション タグ、マトリックス タグは同じでもかまいません。同様に、VisitRequest のソースタグとデスティネーション タグも同じでかまいません。タグはすべて異なっている必要があり、空の文字列にすることはできません。このフィールドが空でない場合、durationDistanceMatrices を空にすることはできません。

transitionAttributes[]

object (TransitionAttributes)

モデルに追加された遷移属性。

shipmentTypeIncompatibilities[]

object (ShipmentTypeIncompatibility)

互換性のない shipment_types のセット(ShipmentTypeIncompatibility を参照)。

shipmentTypeRequirements[]

object (ShipmentTypeRequirement)

shipmentType の要件のセット(ShipmentTypeRequirement を参照)。

precedenceRules[]

object (PrecedenceRule)

モデルに適用する必要がある一連の優先順位ルール。

maxActiveVehicles

integer

アクティブな車両の最大数を制限します。ルートで少なくとも 1 回の配送が行われる車両はアクティブです。これは、ドライバーの数よりも車両の数が少なかったり、車両のフリートが異種である場合に、ルートの数を制限するために使用できます。最適化により、使用する最適な車両のサブセットが選択されます。真に正である必要があります。

配送

1 つの商品の配送(集荷から配達まで)。配送済みと見なされるには、車両がいずれかの集荷場所を訪問し(それに応じて予備容量を減らしてから)、後でいずれかの配達場所を訪問する必要があります(そのため、それに応じて予備容量を再度増やす必要があります)。

JSON 表現
{
  "displayName": string,
  "pickups": [
    {
      object (VisitRequest)
    }
  ],
  "deliveries": [
    {
      object (VisitRequest)
    }
  ],
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "allowedVehicleIndices": [
    integer
  ],
  "costsPerVehicle": [
    number
  ],
  "costsPerVehicleIndices": [
    integer
  ],
  "pickupToDeliveryAbsoluteDetourLimit": string,
  "pickupToDeliveryTimeLimit": string,
  "shipmentType": string,
  "label": string,
  "ignore": boolean,
  "penaltyCost": number,
  "pickupToDeliveryRelativeDetourLimit": number
}
フィールド
displayName

string

配送のユーザー定義の表示名。最大 63 文字で、UTF-8 文字を使用できます。

pickups[]

object (VisitRequest)

配送に関連付けられている受け取りの代替手段のセット。指定されていない場合、車両は配達に対応する場所を訪問するだけで済みます。

deliveries[]

object (VisitRequest)

配送に関連付けられた配送方法のセット。指定されていない場合、車両は乗車に対応する場所を訪問するだけで済みます。

loadDemands

map (key: string, value: object (Load))

荷物の積荷需要(重量、体積、パレット数など)。マップ内のキーは、対応する負荷のタイプを示す識別子である必要があります。また、単位も含めることが理想的です。例: 「weight_kg」、「volume_gallons」、「pallet_count」など。指定されたキーがマップにない場合、対応する負荷は null と見なされます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

allowedVehicleIndices[]

integer

この配送を実行できる車両のセット。空白の場合、すべての車両が実行する可能性があります。車両は、ShipmentModelvehicles リストのインデックスで指定されます。

costsPerVehicle[]

number

この荷物が各車両で配達されたときに発生する費用を指定します。指定する場合は、次のいずれかが必要です。

  • costsPerVehicleIndices と同じ数の要素が含まれている必要があります。costsPerVehicle[i] は、モデルの車両 costsPerVehicleIndices[i] に対応しています。
  • モデル内の車両と同じ数の要素が必要です。i 番目の要素は、モデルの車両 #i に対応しています。

これらの費用は penaltyCost と同じ単位で指定し、負の値にすることはできません。該当する費用がない場合は、このフィールドを空のままにします。

costsPerVehicleIndices[]

integer

costsPerVehicle が適用される車両のインデックス。空でない場合は、要素数が costsPerVehicle と同じである必要があります。車両インデックスは複数回指定できません。車両が costsPerVehicleIndices から除外されている場合、その費用は 0 です。

pickupToDeliveryAbsoluteDetourLimit

string (Duration format)

受け取りから配達までの最短経路と比較して、最大絶対迂回時間を指定します。指定する場合は負の値以外にする必要があります。また、配送には少なくとも受け取りと宅配の 1 つが含まれている必要があります。

たとえば、t は、選択した集荷オプションから選択した配送オプションに直接移動するのにかかる最短時間とします。次に、pickupToDeliveryAbsoluteDetourLimit を設定すると、次が適用されます。

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

同じ配送に相対的制限と絶対的制限の両方が指定されている場合は、受け取りと配達の組み合わせごとに、より制限の厳しい制限が適用されます。2017 ~ 2010 年現在、迂回運転は、移動時間が車両に依存しない場合にのみサポートされます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

pickupToDeliveryTimeLimit

string (Duration format)

荷物の集荷から配達を開始するまでの最長期間を指定します。指定する場合は負の値を指定してください。配送には少なくとも受け取りと宅配の 1 つが含まれている必要があります。これは、受け取りと配達のためにどの代替手段を選択するか、車両の速度には依存しません。これは、最大迂回制約とともに指定できます。ソリューションは両方の指定を尊重します。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

shipmentType

string

この配送の「タイプ」を指定する空でない文字列。この機能は、shipment_types 間の非互換性や要件を定義するために使用できます(ShipmentModelshipmentTypeIncompatibilitiesshipmentTypeRequirements をご覧ください)。

1 回の訪問に指定される visitTypes とは異なります。同じ配送に属するすべての集荷 / 配達で同じ shipmentType が共有されます。

label

string

この配送のラベルを指定します。このラベルは、対応する ShipmentRoute.VisitshipmentLabel でレスポンスに報告されます。

ignore

boolean

true の場合、この配送をスキップしますが、penaltyCost は適用しません。

モデルに shipmentTypeRequirements がある場合、配送を無視すると、検証エラーが発生します。

injectedFirstSolutionRoutes または injectedSolutionConstraint で実行される配送を無視することは許可されています。ソルバは、実行ルートから関連する集荷 / 配達訪問を削除します。無視された配送を参照する precedenceRules も無視されます。

penaltyCost

number

配送が完了していない場合、このペナルティがルートの総費用に追加されます。集荷と配達の代替手段のいずれかを訪問した場合、配送は完了とみなされます。費用は、モデル内の他のすべての費用関連フィールドで使用されている単位で表すことができ、正の値にする必要があります。

重要: このペナルティが指定されていない場合、無限と見なされます。つまり、配送が完了する必要があります。

pickupToDeliveryRelativeDetourLimit

number

集荷から配達までの最短経路と比較した、迂回経路の最大相対時間を指定します。指定する場合は負の値以外にする必要があります。また、配送には少なくとも受け取りと宅配の 1 つが含まれている必要があります。

たとえば、t は、選択した集荷オプションから選択した配送オプションに直接移動するのにかかる最短時間とします。次に、pickupToDeliveryRelativeDetourLimit を設定すると、次が適用されます。

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

同じ配送に相対的制限と絶対的制限の両方が指定されている場合は、受け取りと配達の組み合わせごとに、より制限の厳しい制限が適用されます。2017 ~ 2010 年現在、迂回運転は、移動時間が車両に依存しない場合にのみサポートされます。

VisitRequest

車両で可能な訪問のリクエスト: 位置情報(下記参照、2 つ)、時間枠で表される開店時間と閉店時間、サービス提供期間(車両が荷物の集荷または降車に到着した後の車両が費やした時間)があります。

JSON 表現
{
  "arrivalLocation": {
    object (LatLng)
  },
  "arrivalWaypoint": {
    object (Waypoint)
  },
  "departureLocation": {
    object (LatLng)
  },
  "departureWaypoint": {
    object (Waypoint)
  },
  "tags": [
    string
  ],
  "timeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "duration": string,
  "cost": number,
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "visitTypes": [
    string
  ],
  "label": string,
  "avoidUTurns": boolean
}
フィールド
arrivalLocation

object (LatLng)

この VisitRequest の実行中に車両が到着する位置情報。配送モデルに所要時間距離行列がある場合、arrivalLocation は指定できません。

arrivalWaypoint

object (Waypoint)

この VisitRequest の実行時に車両が到着するウェイポイント。配送モデルに所要時間距離行列がある場合は、arrivalWaypoint を指定しないでください。

departureLocation

object (LatLng)

この VisitRequest の完了後に車両が出発する位置情報。arrivalLocation と同じ場合は省略できます。配送モデルに所要時間距離行列がある場合は、departureLocation を指定しないでください。

departureWaypoint

object (Waypoint)

この VisitRequest を完了した後に車両が出発する地点。arrivalWaypoint と同じ場合は省略できます。配送モデルに所要時間距離行列がある場合は、departureWaypoint を指定しないでください。

tags[]

string

訪問リクエストに関連付けられたタグを指定します。空の文字列や重複する文字列は使用できません。

timeWindows[]

object (TimeWindow)

訪問の到着時間を制限する時間枠。車両は到着時間の範囲外に出発する可能性があります。つまり、到着時間と到着時間が時間枠の範囲内である必要はありません。車両が TimeWindow.start_time より前に到着した場合、待ち時間が生じる可能性があります。

TimeWindow が存在しない場合、車両はいつでもこの訪問を実施できることを意味します。

時間枠は重複しないようにする必要があります。つまり、時間枠が重なったり、隣接したりしないようにし、昇順に並べ替える必要があります。

costPerHourAfterSoftEndTimesoftEndTime は、時間枠が 1 つの場合にのみ設定できます。

duration

string (Duration format)

訪問時間(車両が到着してから出発するまでの時間)(想定される待ち時間に追加します。timeWindows を参照)。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

cost

number

車両ルートでこの訪問リクエストに対応するための費用。これにより、配送の代替の集荷または配達ごとに異なる費用を支払うことができます。この費用は Shipment.penalty_cost と同じ単位で指定し、負の値にすることはできません。

loadDemands

map (key: string, value: object (Load))

このアクセス リクエストの読み込みデマンド。これは Shipment.load_demands フィールドと同じですが、Shipment 全体ではなく、この VisitRequest にのみ適用されます。ここで指定されたデマンド パラメータは、Shipment.load_demands に指定されたデマンド パラメータに追加されます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

visitTypes[]

string

訪問の種類を指定します。これは、車両がこの訪問を完了するために必要な追加の時間を割り当てるために使用されることがあります(Vehicle.extra_visit_duration_for_visit_type を参照)。

型は 1 回だけ使用できます。

label

string

この VisitRequest のラベルを指定します。このラベルは、対応する ShipmentRoute.Visit のレスポンスで visitLabel として報告されます。

avoidUTurns

boolean

この場所で、U ターンを避けたルートを検索するかどうかを指定します。右折 / 左折の回避はベスト エフォートであり、完全に回避できるとは限りません。これは試験運用中の機能であり、動作は変更される可能性があります。

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。

longitude

number

経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。

ウェイポイント

地点をカプセル化します。ウェイポイントは、VisitRequests の到着位置と出発位置、車両の開始位置と終了位置をマークします。

JSON 表現
{
  "sideOfRoad": boolean,

  // Union field location_type can be only one of the following:
  "location": {
    object (Location)
  },
  "placeId": string
  // End of list of possible types for union field location_type.
}
フィールド
sideOfRoad

boolean

省略可。車両が道路の特定の側に停車することを優先して、このウェイポイントの位置を指定します。この値を設定すると、ルートはスポットの中心から偏った側の道路の端に車両を停車できるように、スポットを通過します。このオプションは、移動モードが「歩行」の場合に機能しません。

共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
location

object (Location)

地理座標(オプションの向きを含む)で指定されたポイント。

placeId

string

ウェイポイントに関連付けられているスポット プレイス ID。

場所

ロケーション(地理的なポイント、ヘディング(任意))をカプセル化します。

JSON 表現
{
  "latLng": {
    object (LatLng)
  },
  "heading": integer
}
フィールド
latLng

object (LatLng)

ウェイポイントの地理座標。

heading

integer

トラフィック フローの方向に関連付けられたコンパス方位。この値は、乗車と降車に使用する道路の側面を指定するために使用されます。向きの値は 0~360 の範囲で指定できます。0 は真北の向き、90 は真東の向きなどを指定します。

TimeWindow

時間帯は、訪問の到着時間や車両の開始時間と終了時間など、イベントの時間を制限します。

厳密な時間枠の境界(startTimeendTime)は、イベントの最も早い時刻と最も遅い時刻を適用します(startTime <= event_time <= endTime など)。ソフト時間枠の下限 softStartTime は、イベントが softStartTime より前に発生した場合、発生までの時間に比例した費用が発生するため、イベントが softStartTime 以降に発生することを優先することを表します。ソフトタイム ウィンドウの上限(softEndTime)は、softEndTime またはその前にイベントが発生することを優先し、softEndTime の後、イベントが発生する時間の長さに比例する費用を発生させます。startTimeendTimesoftStartTimesoftEndTime は、グローバル時間制限(ShipmentModel.global_start_timeShipmentModel.global_end_time を参照)内で、以下を遵守する必要があります。

  0 <= `startTime` <= `endTime` and
  0 <= `startTime` <= `softStartTime` and
  0 <= `softEndTime` <= `endTime`.
JSON 表現
{
  "startTime": string,
  "endTime": string,
  "softStartTime": string,
  "softEndTime": string,
  "costPerHourBeforeSoftStartTime": number,
  "costPerHourAfterSoftEndTime": number
}
フィールド
startTime

string (Timestamp format)

ハードタイム ウィンドウの開始時間。指定しない場合は、ShipmentModel.global_start_time に設定されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

ハードタイム ウィンドウの終了時刻。指定しない場合、ShipmentModel.global_end_time に設定されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

softStartTime

string (Timestamp format)

時間枠のソフト開始時間。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

softEndTime

string (Timestamp format)

時間枠のソフト終了時間。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

costPerHourBeforeSoftStartTime

number

イベントが softStartTime より前に発生した場合にモデル内の他の費用に追加される 1 時間あたりの費用。次のように計算されます。

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

この費用は正の値にする必要があります。このフィールドは、softStartTime が設定されている場合にのみ設定できます。

costPerHourAfterSoftEndTime

number

イベントが softEndTime より後に発生した場合に、モデル内の他の費用に加算される 1 時間あたりの費用。次のように計算されます。

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

この費用は正数でなければならず、このフィールドは softEndTime が設定されている場合にのみ設定できます。

車両

配送の問題で車両をモデル化します。配送に関する問題を解決すると、この車両の startLocation から endLocation までのルートが作成されます。経路とは、一連の訪問のことです(ShipmentRoute を参照)。

JSON 表現
{
  "displayName": string,
  "travelMode": enum (TravelMode),
  "startLocation": {
    object (LatLng)
  },
  "startWaypoint": {
    object (Waypoint)
  },
  "endLocation": {
    object (LatLng)
  },
  "endWaypoint": {
    object (Waypoint)
  },
  "startTags": [
    string
  ],
  "endTags": [
    string
  ],
  "startTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "endTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "unloadingPolicy": enum (UnloadingPolicy),
  "loadLimits": {
    string: {
      object (LoadLimit)
    },
    ...
  },
  "costPerHour": number,
  "costPerTraveledHour": number,
  "costPerKilometer": number,
  "fixedCost": number,
  "usedIfRouteIsEmpty": boolean,
  "routeDurationLimit": {
    object (DurationLimit)
  },
  "travelDurationLimit": {
    object (DurationLimit)
  },
  "routeDistanceLimit": {
    object (DistanceLimit)
  },
  "extraVisitDurationForVisitType": {
    string: string,
    ...
  },
  "breakRule": {
    object (BreakRule)
  },
  "label": string,
  "ignore": boolean,
  "travelDurationMultiple": number
}
フィールド
displayName

string

車両のユーザー定義の表示名。長さは 63 文字以下で、UTF-8 文字を使用できます。

travelMode

enum (TravelMode)

移動モード。車両が走行できる道路と速度に影響します。travelDurationMultiple もご覧ください。

startLocation

object (LatLng)

車両が荷物を受け取る前に出発する地理的位置。指定しない場合、車両は最初の乗車から出発します。配送モデルに期間行列と距離行列がある場合、startLocation は指定できません。

startWaypoint

object (Waypoint)

車両が荷物を受け取る前に出発する地理的位置を表す地点。startWaypointstartLocation のどちらも指定されていない場合、車両は最初の乗車から出発します。配送モデルに所要時間と距離のマトリックスがある場合は、startWaypoint を指定しないでください。

endLocation

object (LatLng)

最後の VisitRequest の完了後に車両が終了する地理的な位置。指定しない場合、車両の ShipmentRoute は最後の VisitRequest の完了時に直ちに終了します。配送モデルに期間行列と距離行列がある場合、endLocation は指定できません。

endWaypoint

object (Waypoint)

最後の VisitRequest の完了後に車両が終了する地理的位置を表す地点。endWaypointendLocation のどちらも指定されていない場合、車両の ShipmentRoute は最後の VisitRequest が完了するとすぐに終了します。配送モデルに期間行列と距離行列がある場合、endWaypoint は指定できません。

startTags[]

string

車両のルートの開始点に適用されるタグを指定します。

空の文字列や重複する文字列は使用できません。

endTags[]

string

車両のルートの終点に付けられたタグを指定します。

空の文字列や重複する文字列は使用できません。

startTimeWindows[]

object (TimeWindow)

車両が出発地を出発する時間枠。グローバルな時間制限内である必要があります(ShipmentModel.global_* フィールドを参照)。指定しない場合、グローバルな時間制限以外に制限はありません。

同じ繰り返しフィールドに属する時間枠は重複しない必要があります。つまり、時間枠が重なったり、隣接したりすることはできません。また、時間枠は時系列で並べ替える必要があります。

costPerHourAfterSoftEndTimesoftEndTime は、時間枠が 1 つしかない場合にのみ設定できます。

endTimeWindows[]

object (TimeWindow)

車両が最終目的地に到着する可能性のある時間帯。グローバル制限時間内である必要があります(ShipmentModel.global_* フィールドを参照)。指定しない場合は、グローバルな時間制限以外の制限はありません。

同じ繰り返しフィールドに属する時間枠は重複しない必要があります。つまり、時間枠が重なったり、隣接したりすることはできません。また、時間枠は時系列で並べ替える必要があります。

costPerHourAfterSoftEndTimesoftEndTime は、時間枠が 1 つしかない場合にのみ設定できます。

unloadingPolicy

enum (UnloadingPolicy)

車両に適用されている荷降ろしに関するポリシー。

loadLimits

map (key: string, value: object (LoadLimit))

車両の容量(重量、容積、パレット数など)。マップ内のキーは、読み込みタイプの識別子であり、Shipment.load_demands フィールドのキーと一致します。指定されたキーがこのマップにない場合、対応する容量は無制限とみなされます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

costPerHour

number

車両費用: すべての費用を合計し、Shipment.penalty_cost と同じ単位にする必要があります。

車両ルートの 1 時間あたりの費用。この費用は、ルートの所要時間全体に適用されます。所要時間には、移動時間、待ち時間、訪問時間が含まれます。costPerTraveledHour だけでなく costPerHour を使用すると、レイテンシが増加する可能性があります。

costPerTraveledHour

number

車両ルートの走行 1 時間あたりの費用。この費用は、ルートの移動時間(ShipmentRoute.transitions でレポートされたもの)にのみ適用され、待ち時間と訪問時間は含みません。

costPerKilometer

number

車両ルートの 1 キロメートルあたりの費用。この費用は、ShipmentRoute.transitions でレポートされる距離に適用され、1 つの VisitRequestarrivalLocation から departureLocation まで暗黙的に移動する距離には適用されません。

fixedCost

number

この車両が配送の処理に使用された場合に適用される固定費。

usedIfRouteIsEmpty

boolean

このフィールドは、ルートで荷物を配送しない車両にのみ適用されます。この場合、車両を中古とみなすべきかどうかを指定します。

true の場合、車両は配送サービスを提供していなくても、開始地点から終了地点まで移動します。また、開始地点から終了地点までの移動に伴う時間と距離の費用が考慮されます。

それ以外の場合は、始点から終点まで移動せず、この車両には breakRule も遅延(TransitionAttributes から)もスケジュールされません。この場合、車両の ShipmentRoute には、車両インデックスとラベル以外の情報が含まれません。

routeDurationLimit

object (DurationLimit)

車両のルートの合計時間に適用される上限。ある OptimizeToursResponse における車両のルート時間は、vehicleEndTimevehicleStartTime の差です。

travelDurationLimit

object (DurationLimit)

車両のルートの走行時間に適用される上限。特定の OptimizeToursResponse で、ルートの所要時間はすべての transitions.travel_duration の合計です。

routeDistanceLimit

object (DistanceLimit)

車両のルートの合計距離に適用される制限。ある特定の OptimizeToursResponse におけるルート距離は、そのすべての transitions.travel_distance_meters の合計です。

extraVisitDurationForVisitType

map (key: string, value: string (Duration format))

visitTypes 文字列から所要時間へのマップを指定します。所要時間は、指定された visitTypes での訪問時に VisitRequest.duration に加えて取られる時間です。costPerHour が指定されている場合、この追加の訪問時間により費用が増加します。キー(visitTypes など)は空の文字列にできません。

訪問リクエストに複数のタイプがある場合は、マップの各タイプに所要時間が追加されます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

breakRule

object (BreakRule)

この車両に適用される休憩スケジュールを記述します。空白の場合、この車両には休憩はスケジュールされません。

label

string

この車両のラベルを指定します。このラベルは、対応する ShipmentRoutevehicleLabel としてレスポンスで報告されます。

ignore

boolean

true の場合、usedIfRouteIsEmpty は false である必要があり、この車両は使用されないままになります。

injectedFirstSolutionRoutes で無視された車両によって配送が行われた場合、最初のソリューションではスキップされますが、レスポンスでは自由に行うことができます。

injectedSolutionConstraint で無視される車両によって配送が行われ、関連する集荷 / 配達がその車両に留まるように制約されている場合(レベル RELAX_ALL_AFTER_THRESHOLD に緩和されていない場合)、レスポンスでスキップされます。配送の allowedVehicleIndices フィールドが空でなく、許可された車両がすべて無視された場合は、レスポンスでスキップされます。

travelDurationMultiple

number

この車両の移動時間を増減するために使用できる乗法係数を指定します。たとえば、この値を 2.0 に設定すると、この車両は標準車両の 2 倍の所要時間で移動することになります。この倍率は、訪問時間には影響しません。costPerHour または costPerTraveledHour が指定されている場合は、費用に影響します。[0.001, 1000.0] の範囲内で指定する必要があります。未設定の場合、車両は標準で、この倍率は 1.0 と見なされます。

警告: 移動時間は、この倍数を適用した後、数値演算を実行する前に最も近い秒単位に丸められます。そのため、乗数の値が小さいと精度が低下する可能性があります。

下記の extraVisitDurationForVisitType もご覧ください。

TravelMode

車両で使用できる移動手段。

これらは、Google Maps Platform Routes Preferred API の移動モードのサブセットである必要があります。https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode をご覧ください。

列挙型
TRAVEL_MODE_UNSPECIFIED 未指定の移動手段。DRIVING と同等。
DRIVING ルート案内に該当する交通手段(自動車など)。
WALKING 徒歩ルートに対応する移動手段。

UnloadingPolicy

車両の荷降ろし方法に関するポリシー。受け取りと宅配の両方を行う配送にのみ適用されます。

それ以外の配送は、unloadingPolicy に関係なく、経路のどこでも無料で行うことができます。

列挙型
UNLOADING_POLICY_UNSPECIFIED 未設定のアンロード ポリシー: 配送は対応する集荷後に行う必要があります。
LAST_IN_FIRST_OUT 配送は受け取りの逆の順序で行う必要がある
FIRST_IN_FIRST_OUT 配送は集荷と同じ順序で行う必要があります

LoadLimit

車両に適用する積載量の上限を定義します(例: 「このトラックは 3, 500 kg まで積載できます」)。loadLimits をご覧ください。

JSON 表現
{
  "softMaxLoad": string,
  "costPerUnitAboveSoftMax": number,
  "startLoadInterval": {
    object (Interval)
  },
  "endLoadInterval": {
    object (Interval)
  },
  "maxLoad": string
}
フィールド
softMaxLoad

string (int64 format)

負荷のソフトリミット。costPerUnitAboveSoftMax をご覧ください。

costPerUnitAboveSoftMax

number

この車両のルートで負荷が softMaxLoad を超えた場合は、(車両ごとに 1 回のみ)次の費用ペナルティが適用されます(load - softMaxLoad)* costPerUnitAboveSoftMax。すべての費用を合計し、Shipment.penalty_cost と同じ単位にする必要があります。

startLoadInterval

object (Interval)

ルートの開始時点で許容される車両の積載間隔。

endLoadInterval

object (Interval)

ルートの終点における車両の許容積載間隔。

maxLoad

string (int64 format)

許容される最大負荷量。

間隔

許容される負荷量の間隔。

JSON 表現
{
  "min": string,
  "max": string
}
フィールド
min

string (int64 format)

許容される最小負荷。0 以上である必要があります。両方を指定する場合は、minmax 以下にする必要があります。

max

string (int64 format)

許容できる最大負荷。0 以上にする必要があります。指定しない場合、最大負荷は制限されません。両方が指定されている場合は、minmax 以下である必要があります。

DurationLimit

車両のルートの最大時間を定義する上限。ハードにもソフトにもできます。

ソフトリミット フィールドを定義する場合は、ソフトマックスしきい値とそれに関連付けられた費用の両方を一緒に定義する必要があります。

JSON 表現
{
  "maxDuration": string,
  "softMaxDuration": string,
  "quadraticSoftMaxDuration": string,
  "costPerHourAfterSoftMax": number,
  "costPerSquareHourAfterQuadraticSoftMax": number
}
フィールド
maxDuration

string (Duration format)

期間を maxDuration 以下に制限するハード制限。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

softMaxDuration

string (Duration format)

ソフトリミットは最大時間制限を適用しませんが、違反するとルートにコストが発生します。この費用は、モデルで定義された他の費用と合計され、同じ単位で表されます。

定義する場合、softMaxDuration は正の値にする必要があります。maxDuration も定義されている場合、softMaxDuration は maxDuration より小さくする必要があります。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

quadraticSoftMaxDuration

string (Duration format)

ソフトリミットでは、最大時間制限は適用されませんが、違反すると、ルートに時間の 2 乗に比例する費用が発生します。この費用は、モデルで定義された他の費用と合計され、同じ単位で表されます。

定義する場合、quadraticSoftMaxDuration には負でない値を指定する必要があります。maxDuration も定義されている場合、quadraticSoftMaxDurationmaxDuration より小さく、差は 1 日を超えないようにする必要があります。

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

costPerHourAfterSoftMax

number

softMaxDuration のしきい値に違反した場合の 1 時間あたりの費用。期間がしきい値を下回ると、追加費用は 0 になります。しきい値を下回っている場合は、費用は次のように期間によって異なります。

  costPerHourAfterSoftMax * (duration - softMaxDuration)

費用は正の値にする必要があります。

costPerSquareHourAfterQuadraticSoftMax

number

quadraticSoftMaxDuration のしきい値違反があった場合に発生する 1 平方時間あたりの費用。

期間がしきい値を下回ると、追加費用は 0 になります。しきい値を下回っている場合は、費用は次のように期間によって異なります。

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

費用は正の値にする必要があります。

DistanceLimit

移動可能な最大距離を定義する制限。ハードまたはソフトのいずれかです。

ソフトリミットが定義されている場合、softMaxMeterscostPerKilometerAboveSoftMax の両方を定義し、正の値にする必要があります。

JSON 表現
{
  "maxMeters": string,
  "softMaxMeters": string,
  "costPerKilometerAboveSoftMax": number
}
フィールド
maxMeters

string (int64 format)

距離を maxMeters 以下に制限するハードリミットです。上限は負でない値にしてください。

softMaxMeters

string (int64 format)

ソフトリミットは最大距離制限を適用しませんが、違反すると、モデルで定義されている他の費用に同じ単位で加算される費用が発生します。

定義する場合、softMaxMeters は maxMeters より小さく、負でない値にする必要があります。

costPerKilometerAboveSoftMax

number

距離が softMaxMeters の上限を超える場合、1 キロメートルあたりの費用が発生します。距離が制限内の場合は追加料金は 0 円ですが、制限を超える場合は、次の式で費用が計算されます。

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

費用は正の値にする必要があります。

BreakRule

車両の休憩(昼休みなど)を生成するルール。休憩とは、車両が現在の位置でアイドル状態のままで、訪問を実行できない連続した期間です。次のような場合に中断が発生する可能性があります。

  • 2 回の訪問間の移動中(訪問の前後を含むが、訪問中は含まない)に発生した場合、その訪問間の移動時間が延長されます。
  • 車両の始動前(休憩の途中で始動しない場合もあります)。この場合、車両の始動時間には影響しません。
  • または車両の終了時間(車両の終了時間も同様)以降に開始します。
JSON 表現
{
  "breakRequests": [
    {
      object (BreakRequest)
    }
  ],
  "frequencyConstraints": [
    {
      object (FrequencyConstraint)
    }
  ]
}
フィールド
breakRequests[]

object (BreakRequest)

休憩の順序。BreakRequest メッセージを参照してください。

frequencyConstraints[]

object (FrequencyConstraint)

複数の FrequencyConstraint が適用される場合があります。これらはすべて、この BreakRuleBreakRequest で満たされる必要があります。FrequencyConstraint をご覧ください。

BreakRequest

各車両に適用される休憩の順序(数と順序)を事前に把握しておく必要があります。繰り返される BreakRequest は、そのシーケンスを発生させる順序で定義します。時間枠(earliestStartTime / latestStartTime)は重複する場合がありますが、順序との互換性がある必要があります(チェックが入っています)。

JSON 表現
{
  "earliestStartTime": string,
  "latestStartTime": string,
  "minDuration": string
}
フィールド
earliestStartTime

string (Timestamp format)

必須。休憩の開始時間の下限(その時間を含む)。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

latestStartTime

string (Timestamp format)

必須。ブレーク開始の上限(両端を含む)。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

minDuration

string (Duration format)

必須。休憩の最小時間。正の値である必要があります。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

FrequencyConstraint

「12 時間ごとに少なくとも 1 時間の休憩が必要」など、休憩の最小頻度を適用することで、上記で指定する休憩の頻度と期間を、さらに制限することもできます。これは「12 時間のスライディング タイム ウィンドウ内に、1 時間以上の休憩を 1 回以上設けること」と解釈できます。この例は、次の FrequencyConstraint に変換されます。

{
   minBreakDuration { seconds: 3600 }         # 1 hour.
   maxInterBreakDuration { seconds: 39600 }  # 11 hours (12 - 1 = 11).
}

ソリューション内の休憩のタイミングと長さは、BreakRequest ですでに指定されている時間帯と最小時間に加えて、このような制約をすべて遵守します。

FrequencyConstraint は、連続していない休憩にも適用できます。たとえば、次のスケジュールでは「12 時間ごとに 1 時間」の例が適用されます。

  04:00 vehicle start
   .. performing travel and visits ..
  09:00 1 hour break
  10:00 end of the break
   .. performing travel and visits ..
  12:00 20-min lunch break
  12:20 end of the break
   .. performing travel and visits ..
  21:00 1 hour break
  22:00 end of the break
   .. performing travel and visits ..
  23:59 vehicle end
JSON 表現
{
  "minBreakDuration": string,
  "maxInterBreakDuration": string
}
フィールド
minBreakDuration

string (Duration format)

必須。この制約の最小休憩時間。非負。FrequencyConstraint の説明をご覧ください。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

maxInterBreakDuration

string (Duration format)

必須。duration >= minBreakDuration の中断部分を含まない、ルートの任意の時間間隔の最大許容スパン。正の値である必要があります。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

DurationDistanceMatrix

訪問場所、車両の出発点から訪問までの所要時間と距離の行列を指定します。

JSON 表現
{
  "rows": [
    {
      object (Row)
    }
  ],
  "vehicleStartTag": string
}
フィールド
rows[]

object (Row)

期間と距離の行列の行を指定します。ShipmentModel.duration_distance_matrix_src_tags と同じ数の要素が必要です。

vehicleStartTag

string

この所要時間と距離行列を適用する車両を定義するタグ。空の場合、すべての車両に適用されます。マトリックスは 1 つだけです。

各車両の開始は、1 つの行列と完全に一致する必要があります。つまり、startTags フィールドのいずれかが、行列の vehicleStartTag と完全に一致する必要があります(その行列のみ)。

すべての行列の vehicleStartTag は異なる必要があります。

期間と距離の行列の行を指定します。

JSON 表現
{
  "durations": [
    string
  ],
  "meters": [
    number
  ]
}
フィールド
durations[]

string (Duration format)

特定の行の所要時間の値。ShipmentModel.duration_distance_matrix_dst_tags と同じ数の要素が必要です。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

meters[]

number

特定の行の距離値。モデル内の距離を参照する費用や制約がない場合は、空のままにできます。それ以外の場合は、durations と同じ数の要素が必要です。

TransitionAttributes

ルート上の 2 つの連続した訪問間の遷移の属性を指定します。同じ遷移に複数の TransitionAttributes が適用される場合があります。その場合、すべての追加費用が合計され、最も厳しい制約または上限が適用されます(自然な「AND」セマンティクスに従います)。

JSON 表現
{
  "srcTag": string,
  "excludedSrcTag": string,
  "dstTag": string,
  "excludedDstTag": string,
  "cost": number,
  "costPerKilometer": number,
  "distanceLimit": {
    object (DistanceLimit)
  },
  "delay": string
}
フィールド
srcTag

string

これらの属性が適用される(src->dst)遷移のセットを定義するタグ。

ソース訪問または車両の開始が一致するのは、VisitRequest.tags または Vehicle.start_tagssrcTag が含まれているか、excludedSrcTag が含まれていないか(この 2 つのフィールドのどちらが空でないかによって異なります)場合のみです。

excludedSrcTag

string

srcTag をご覧ください。srcTagexcludedSrcTag のいずれか 1 つのみを空にすることはできません。

dstTag

string

目的地の訪問または車両の終了は、VisitRequest.tags または Vehicle.end_tagsdstTag が含まれているか、excludedDstTag(空でないフィールド)を含んでいない場合に一致します。

excludedDstTag

string

dstTag をご覧ください。dstTagexcludedDstTag のいずれか 1 つのみを空にすることはできません。

cost

number

この遷移を実行する費用を指定します。これは、モデルの他のすべての費用と同じ単位であり、負の値にすることはできません。既存の他のすべての費用に上乗せされます。

costPerKilometer

number

この移行中に移動した距離に適用される 1 キロメートルあたりの費用を指定します。車両に指定されている Vehicle.cost_per_kilometer を合計します。

distanceLimit

object (DistanceLimit)

この遷移中の移動距離の上限を指定します。

2021 年 6 月現在、ソフトリミットのみがサポートされています。

delay

string (Duration format)

この移行の際に発生する遅延を指定します。

この遅延は、常に参照元のアクセスが完了した、リンク先のアクセスが開始されるに発生します。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

ShipmentTypeIncompatibility

配送の種類に応じて、配送間の互換性がないことを示します。互換性のない配送が同じルートに表示されるかどうかは、互換性モードに基づいて制限されます。

JSON 表現
{
  "types": [
    string
  ],
  "incompatibilityMode": enum (IncompatibilityMode)
}
フィールド
types[]

string

互換性のないタイプのリスト。リスト内の異なる shipment_types を持つ 2 つの配送は「互換性なし」です。

incompatibilityMode

enum (IncompatibilityMode)

互換性がない場合に適用されるモード。

IncompatibilityMode

同じルートで互換性のない配送の表示を制限する方法を指定するモード。

列挙型
INCOMPATIBILITY_MODE_UNSPECIFIED 未指定の非互換モード。この値は使用しないでください。
NOT_PERFORMED_BY_SAME_VEHICLE このモードでは、互換性のないタイプの 2 つの配送で同じ車両を共有することはできません。
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY

NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY 非互換性モードの、互換性のないタイプの 2 つの出荷の場合:

  • 両方が受け取りのみ(配達なし)または配送のみ(受け取りなし)の場合、同じ車両を共有することはできません。
  • 一方の荷物が配達で、もう一方が集荷の場合、前者の荷物が引き取りに来る前であれば、2 つの配送で同じ車両を共有できます。

ShipmentTypeRequirement

shippingType に基づいて、配送間の要件を指定します。要件の詳細は、要件モードによって定義されます。

JSON 表現
{
  "requiredShipmentTypeAlternatives": [
    string
  ],
  "dependentShipmentTypes": [
    string
  ],
  "requirementMode": enum (RequirementMode)
}
フィールド
requiredShipmentTypeAlternatives[]

string

dependentShipmentTypes で必要な代替の配送タイプのリスト。

dependentShipmentTypes[]

string

dependentShipmentTypes フィールドにタイプが指定されているすべての配送には、同じルートで requiredShipmentTypeAlternatives タイプの配送が少なくとも 1 件必要です。

注: shipmentType が自身に依存するような要件の連鎖は許可されません。

requirementMode

enum (RequirementMode)

要件に適用されるモード。

RequirementMode

ルート上の依存する配送の表示を定義するモード。

列挙型
REQUIREMENT_MODE_UNSPECIFIED 未指定の要件モード。この値は使用しないでください。
PERFORMED_BY_SAME_VEHICLE このモードでは、「依存」するすべての配送が少なくとも 1 つの「必須」配送と同じ車両を共有する必要があります。
IN_SAME_VEHICLE_AT_PICKUP_TIME

IN_SAME_VEHICLE_AT_PICKUP_TIME モードでは、すべての「依存」配送で、集荷時に車両に「必須」配送が 1 つ以上含まれている必要があります。

そのため、「依存」する配送の集荷には、次のいずれかが必要です。

  • 配送のみの「必須」の荷物が次の日付より後に配送された、または
  • 「必須」の荷物がそれよりも前のルートで集荷され、「必須」の荷物に配送がある場合、この配送は「従属」の荷物の集荷の後に行う必要があります。
IN_SAME_VEHICLE_AT_DELIVERY_TIME 以前と同じですが、「依存」する荷物は、配達時に車両に「必須」な荷物が積まれている必要があります。

PrecedenceRule

2 つのイベント(各イベントは荷物の集荷または配達)間の優先ルール: 「2 番目」のイベントは、「1 番目」のイベントの開始から少なくとも offsetDuration 後に開始する必要があります。

複数の優先度が同じ(または関連する)イベントを参照できます(例:「B の集荷は A の配送後に行われます」、「C の集荷は B の集荷後に行われます」。

また、優先順位は両方の発送が行われた場合にのみ適用され、それ以外の場合は無視されます。

JSON 表現
{
  "firstIsDelivery": boolean,
  "secondIsDelivery": boolean,
  "offsetDuration": string,
  "firstIndex": integer,
  "secondIndex": integer
}
フィールド
firstIsDelivery

boolean

「最初」のイベントが配信であるかどうかを示します。

secondIsDelivery

boolean

「2 番目」のイベントが配信かどうかを示します。

offsetDuration

string (Duration format)

「first」イベントと「second」イベントの間のオフセット。負の値にすることもできます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

firstIndex

integer

「最初の」イベントの配送インデックス。このフィールドを指定する必要があります。

secondIndex

integer

「2 回目」のイベントの配送インデックス。このフィールドを指定する必要があります。