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، ما يؤكد اكتمال حذف المورد.