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"

في حال النجاح، تعرض واجهة برمجة التطبيقات عنصر JSON فارغًا.

حذف المسارات بشكل مجمّع

لحذف مسارات متعددة في طلب واحد، استخدِم نقطة النهاية batchDelete. تتيح لك نقطة النهاية هذه حذف ما يصل إلى 1,000 مسار في مكالمة واحدة. تكون عملية الحذف المجمّع كلّية: إذا تعذّر حذف أي مسار في طلب الحذف المجمّع أو كان مفقودًا، لن يتم حذف أي مسار في الحزمة.

أرسِل طلب 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"

في حال النجاح، تعرض واجهة برمجة التطبيقات عنصر JSON فارغًا. تتوقّف عملية جمع البيانات على المسار المحذوف فورًا. تكتمل عملية حذف الموارد بشكل دائم في الخلفية، وقد تستغرق بضع دقائق عند حذف مجموعات كبيرة.

استخدِم عملية get للاطّلاع على حالة مسارك. تؤدي إعادة محاولة إرسال طلب بعد انتهاء عملية الحذف النهائي إلى عرض الخطأ 404 Not Found، ما يؤكّد اكتمال عملية حذف المورد.