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

ส่งคำขอ 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 ว่าง การเก็บรวบรวมข้อมูลในเส้นทางที่ลบจะหยุดลงทันที การลบทรัพยากรอย่างถาวรจะเสร็จสมบูรณ์ในเบื้องหลัง และอาจใช้เวลา 2-3 นาทีจึงจะเสร็จสมบูรณ์สำหรับขนาดแบบหลายรายการขนาดใหญ่

ใช้การดำเนินการ get เพื่อตรวจสอบสถานะของเส้นทาง การลองส่งคำขออีกครั้งหลังจากลบอย่างถาวรเสร็จสิ้นแล้วจะแสดงข้อผิดพลาด 404 Not Found ซึ่งยืนยันว่าการลบทรัพยากรเสร็จสมบูรณ์แล้ว