Delete selected routes

Trang này mô tả cách dừng thu thập dữ liệu bằng Roads Selection API:

Xoá tuyến đường

Gửi yêu cầu DELETE đến điểm cuối delete để xoá một tuyến đường đã chọn khỏi dự án của bạn và ngừng thu thập dữ liệu.

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

Yêu cầu phải bao gồm số dự án và name của SelectedRoute cần xoá.

Mã mẫu sau đây cho thấy cấu trúc của một yêu cầu DELETE đến điểm cuối 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"

Khi thành công, API sẽ trả về một đối tượng JSON trống.

Xoá hàng loạt tuyến đường

Để xoá nhiều tuyến đường trong một yêu cầu, hãy sử dụng điểm cuối batchDelete. Điểm cuối này cho phép bạn xoá tối đa 1.000 tuyến đường trong một lệnh gọi. Xoá theo lô có tính chất độc lập: nếu có tuyến đường nào trong yêu cầu theo lô bị lỗi hoặc bị thiếu, thì không có tuyến đường nào trong lô bị xoá.

Gửi yêu cầu POST đến điểm cuối batchDelete:

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

Nội dung yêu cầu phải là một đối tượng JSON chứa một mảng names. Mỗi phần tử chuỗi trong mảng này là name của SelectedRoute cần xoá.

Mã mẫu sau đây cho thấy cấu trúc của một yêu cầu POST đến điểm cuối 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"

Khi thành công, API sẽ trả về một đối tượng JSON trống. Quá trình thu thập dữ liệu trên tuyến đường đã xoá sẽ dừng ngay lập tức. Quá trình xoá tài nguyên vĩnh viễn diễn ra ở chế độ nền và có thể mất vài phút để hoàn tất đối với các kích thước lô lớn.

Sử dụng thao tác get để kiểm tra trạng thái của tuyến đường. Việc thử lại một yêu cầu sau khi xoá vĩnh viễn xong sẽ trả về lỗi 404 Not Found, xác nhận rằng quá trình xoá tài nguyên đã hoàn tất.