Delete selected routes

本頁面說明如何使用 Roads Selection API 停止收集資料：

  • 刪除路線：使用 delete 端點停止收集單一路線的資料。
  • 批次刪除路線：使用 batchDelete 端點，在單一要求中停止收集多條路線的資料。

刪除路由

傳送 DELETE 要求至 delete 端點，從專案中刪除所選路線，並停止資料收集。

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID

要求必須包含專案編號和要刪除的 SelectedRoute 的 name。

以下程式碼範例顯示傳送至 delete 端點的 DELETE 要求結構：

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/"\
"PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID"

如果成功，API 會傳回空白的 JSON 物件。

批次刪除路由

如要在單一要求中刪除多條路線，請使用 batchDelete 端點。這個端點可讓您在一次呼叫中刪除最多 1,000 條路線。批次刪除作業具有不可分割的特性：如果批次要求中的任何路徑失敗或遺失，系統就不會刪除批次中的任何路徑。

將 POST 要求傳送至 batchDelete 端點：

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes:batchDelete

要求主體必須是包含 names 陣列的 JSON 物件。這個陣列中的每個字串元素都是要刪除的 SelectedRoute 的 name。

以下程式碼範例顯示傳送至 batchDelete 端點的 POST 要求結構：

curl -X POST -d '
    {"names": [
      "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_1",
      "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_2"
    ]}' \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/"\
"PROJECT_NUMBER/selectedRoutes:batchDelete"

如果成功，API 會傳回空白的 JSON 物件。系統會立即停止收集已刪除路徑的資料。系統會在背景中永久刪除資源，如果批次大小較大，可能需要幾分鐘才能完成。

使用 get 作業檢查路線狀態。永久刪除完成後，如果重試要求，系統會傳回 404 Not Found 錯誤，確認資源刪除作業已完成。