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 נכשל או חסר, אף מסלול לא נמחק.

שליחת בקשת 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, שתאשר שהמחיקה של המשאב הושלמה.