Delete selected routes

Halaman ini menjelaskan cara menghentikan pengumpulan data menggunakan Roads Selection API:

  • Menghapus rute: Menghentikan pengumpulan data untuk satu rute menggunakan delete endpoint.
  • Menghapus rute secara batch: Menghentikan pengumpulan data untuk beberapa rute dalam satu permintaan menggunakan endpoint batchDelete.

Menghapus rute

Kirim permintaan DELETE ke endpoint delete untuk menghapus rute yang dipilih dari project Anda dan menghentikan pengumpulan data.

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID

Permintaan harus menyertakan nomor project dan name dari SelectedRoute yang akan dihapus.

Contoh kode berikut menunjukkan struktur permintaan DELETE ke endpoint 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"

Jika berhasil, API akan menampilkan objek JSON kosong.

Menghapus rute secara batch

Untuk menghapus beberapa rute dalam satu permintaan, gunakan batchDelete endpoint. Endpoint ini memungkinkan Anda menghapus hingga 1.000 rute dalam satu panggilan. Penghapusan batch bersifat atomik: jika ada rute dalam permintaan batch yang gagal atau tidak ada, tidak ada rute dalam batch yang dihapus.

Kirim permintaan POST ke endpoint batchDelete:

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes:batchDelete

Isi permintaan harus berupa objek JSON yang berisi array names. Setiap elemen string dalam array ini adalah name dari a SelectedRoute yang akan dihapus.

Contoh kode berikut menunjukkan struktur permintaan POST ke endpoint 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"

Jika berhasil, API akan menampilkan objek JSON kosong. Pengumpulan data pada rute yang dihapus akan segera berhenti. Penghapusan resource permanen selesai di latar belakang, dan dapat memerlukan waktu beberapa menit untuk diselesaikan untuk ukuran batch yang besar.

Gunakan operasi get untuk memeriksa status rute Anda. Mencoba kembali permintaan setelah penghapusan permanen selesai akan menampilkan error 404 Not Found, yang mengonfirmasi bahwa penghapusan resource telah selesai.