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 条路线。批量删除是原子性的：如果批量请求中的任何路由失败或缺失，则不会删除批量中的任何路由。

向 batchDelete 端点发送 POST 请求：

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 错误，从而确认资源删除已完成。