این صفحه نحوهی توقف جمعآوری دادهها با استفاده از 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 را برمیگرداند که تأیید میکند حذف منبع به پایان رسیده است.