Delete selected routes

این صفحه نحوه توقف جمع‌آوری داده‌ها بااستفاده از Roads Selection API را شرح می‌دهد:

  • حذف مسیر: جمع‌آوری داده را برای یک مسیر بااستفاده از نقطه پایانی delete متوقف کنید.
  • حذف دسته‌ای مسیرها: جمع‌آوری داده‌ها را برای چندین مسیر در یک درخواست بااستفاده از نقطه پایانی batchDelete متوقف کنید.

حذف مسیر

درخواست 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 استفاده کنید. این نقطه پایانی به شما امکان می‌دهد تا ۱۰۰۰ مسیر را در یک تماس حذف کنید. حذف دسته‌ای اتمی است: اگر هر مسیری در درخواست دسته‌ای ناموفق باشد یا وجود نداشته باشد، هیچ مسیری در دسته حذف نمی‌شود.

درخواست 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 را برمی‌گرداند که تأیید می‌کند حذف منبع تکمیل شده است.