Method: networks.shipments.route

安排新的出貨商品。這個作業與建立類似,只代表狀態變更。

HTTP 要求

POST https://middlemileoptimization.googleapis.com/v1/{parent=networks/*}/shipments:route

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。父項,這是運送訂單所在的網路。格式:「networks/{network}」

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "shipment": {
    object (Shipment)
  }
}
欄位
shipment

object (Shipment)

必要欄位。要轉送的貨品。

回應主體

shipments.route 方法的回應訊息。

如果成功,回應主體會含有以下結構的資料:

JSON 表示法
{
  "shipment": {
    object (Shipment)
  },
  "paths": [
    {
      object (Path)
    }
  ],
  "lines": [
    {
      object (GeneratedLineAndRotation)
    }
  ]
}
欄位
shipment

object (Shipment)

剛剛建立的出貨。

paths[]

object (Path)

因轉送出貨而變更的路徑。這個欄位至少包含一個項目,也就是必須轉送的運送路徑。它可以包含其他運送路徑,以反映內部狀態的變更。

lines[]

object (GeneratedLineAndRotation)

安排出貨時建立的線條旋轉。顏色可能為空白,或包含其他運送項目的旋轉資訊,以反映內部狀態的變更。

GeneratedLineAndRotation

由這個 API (而非 API 客戶) 產生一行程式碼的輪替憑證。它本身不受限制,而且可以使用任何車輛 (除非 API 客戶在後續呼叫中做出其他決定)。

JSON 表示法
{
  "arrivalTimes": {
    string: {
      object (DateTime)
    },
    ...
  },
  "departureTimes": {
    string: {
      object (DateTime)
    },
    ...
  }
}
欄位
arrivalTimes

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

僅供輸出。對應中樞 ID 和時間。這張對應應有相同的鍵 (刪除來源中樞,沒有抵達時間)。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

departureTimes

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

僅供輸出。對應中樞 ID 和時間。這張地圖應有相同的按鍵 (減去目的地中樞,沒有出發時間)。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }