Delete selected routes

На этой странице описано, как прекратить сбор данных с помощью Roads Selection API.

Удаление маршрута

Чтобы удалить выбранный маршрут из проекта и прекратить сбор данных, отправьте запрос DELETE к конечной точке delete.

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

Запрос должен содержать номер проекта и name удаляемого SelectedRoute.

В приведенном ниже примере кода показана структура запроса 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. Эта конечная точка позволяет удалить до 1000 маршрутов за один вызов. Пакетное удаление является атомарным: если какой-либо маршрут в пакетном запросе не удается удалить или отсутствует, маршруты в пакете не удаляются.

Отправьте запрос POST конечной точке batchDelete:

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

Тело запроса должно быть объектом JSON, содержащим массив names. Каждый строковый элемент в этом массиве – это name объекта SelectedRoute, который нужно удалить.

В приведенном ниже примере кода показана структура запроса POST к конечной точке batchDelete.

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, подтверждающую, что удаление ресурса завершено.