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. נקודת הקצה הזו מאפשרת למחוק עד 1,000 מסלולים בקריאה אחת. מחיקה של Batch היא פעולה אטומית: אם מסלול כלשהו בבקשת Batch נכשל או חסר, אף אחד מהמסלולים ב-Batch לא נמחק.

שולחים בקשת POST לנקודת הקצה (endpoint) של 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, שמאשרת שהמחיקה של המשאב הושלמה.