Delete selected routes

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

  • Xoá tuyến đường: Ngừng thu thập dữ liệu cho một tuyến đường bằng cách sử dụng điểm cuối delete.
  • Xoá tuyến đường hàng loạt: Ngừng thu thập dữ liệu cho nhiều tuyến đường trong một yêu cầu bằng cách sử dụng điểm cuối batchDelete.

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"

Nếu 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. Thao tác xoá hàng loạt là thao tác nguyên tử: nếu có bất kỳ tuyến đường nào trong yêu cầu hàng loạt không thành công 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ảng names. Mỗi phần tử chuỗi trong mảng này là name của một 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"

Nếu 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á vĩnh viễn tài nguyên sẽ hoàn tất trong nền và có thể mất vài phút để hoàn tất đối với các lô có kích thước lớn.

Sử dụng thao tác get để kiểm tra trạng thái của tuyến đường. Nếu bạn thử lại một yêu cầu sau khi quá trình xoá vĩnh viễn hoàn tất, thì hệ thống 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.