單一非阻斷最佳化 API 方法

本指南將介紹 OptimizeToursLongRunning 和 OptimizeToursUri API 方法的實驗性發布，使用者可透過這些方法提出單一非封鎖最佳化要求。在非封鎖最佳化中，使用者會從方法快速收到 Operation Proto，可用於呼叫 GetOperation 參照最佳化狀態。詳情請參閱「長時間執行的作業」。

相較於封鎖 OptimizeTours 方法，這些非封鎖方法可提供可靠性優勢，因為用戶端在執行最佳化作業時，不需要維持與伺服器的連線。此外，與 BatchOptimizeTours 相比，這些新方法也更容易偵錯失敗，因為每項最佳化作業都與單一長時間執行的作業 (LRO) 相關聯。

如要內嵌最佳化要求，請使用 OptimizeToursLongRunning 方法；如要上傳要求並使用 Google Cloud Storage 讀取回應，請使用 OptimizeToursUri 方法。

OptimizeToursLongRunning

範例：發出 OptimizeToursLongRunning 要求

提出要求前，請將下列參數替換為適合您環境的值：

• 請確認您已按照「使用 OAuth」一文所述，設定應用程式預設憑證。

• 將 PROJECT_NUMBER_OR_ID 設為 Cloud 專案編號或 ID。

  下列指令會將 OptimizeToursLongRunning 要求傳送至 Route Optimization API，並接收與該要求相關聯的作業 ID。GetOperation 方法可用於查詢作業狀態。作業完成後，中繼資料也會包含最終的 OptimizeToursResponse。

  curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeToursLongRunning' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  --data @- <<EOM
  {
    "model": {
      "shipments": [
        {
          "pickups": [
            {
              "arrivalLocation": {
                "latitude": 37.42506261000996,
                "longitude": -122.09535511930135
              }
            }
          ],
          "deliveries": [
            {
              "arrivalLocation": {
                "latitude": 37.42421503206021,
                "longitude": -122.09526063135228
              }
            }
          ]
        }
      ],
      "vehicles": [
        {
          "travelMode": "DRIVING",
          "costPerKilometer": 1.0
        }
      ],
    }
  }
  EOM

OptimizeToursUri

與 BatchOptimizeTours 類似，您可以使用 OptimizeToursUri，繼續在 Google Cloud Storage 中儲存最佳化要求和回應。Cloud Storage URI 必須在 OptimizeToursUri 要求訊息中指定。傳回的 Operation 狀態只與單一提交的 OptimizeToursRequest 相關聯。

範例：發出 OptimizeToursUri 要求

提出要求前，請將下列參數替換為適合您環境的值：

• 請確認您已按照「使用 OAuth」一文所述，設定應用程式預設憑證。

• 將 PROJECT_NUMBER_OR_ID 設為 Cloud 專案編號或 ID。

  下列指令會將 OptimizeToursUri 要求傳送至 Route Optimization API，並接收與該要求相關聯的作業 ID。使用 GetOperation 方法查詢作業狀態。作業完成後，OptimizeToursResponse 會遠端儲存在要求中提供的輸出 URI 路徑。

  curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeToursUri' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  --data @- <<EOM
  {
    "input": {
      "uri": "gs://bucket/path/input/object.json"
    },
    "output": {
      "uri": "gs://bucket/path/output/object.json"
    }
  }
  EOM