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 เส้นทางในการเรียกใช้ 1 ครั้ง การลบแบบกลุ่มเป็นแบบอะตอม กล่าวคือ หากเส้นทางใดๆ ในคำขอแบบกลุ่มไม่สำเร็จหรือขาดหายไป ระบบจะไม่ลบเส้นทางใดๆ ในกลุ่ม

ส่งคำขอ 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 ซึ่งเป็นการยืนยันว่าการลบทรัพยากรเสร็จสมบูรณ์แล้ว