Delete selected routes

Na tej stronie opisaliśmy, jak zatrzymać zbieranie danych za pomocą interfejsu Roads Selection API:

  • Usuwanie trasy: zatrzymaj zbieranie danych dla pojedynczej trasy za pomocą punktu końcowego delete.
  • Usuwanie zbiorcze tras: zatrzymaj zbieranie danych dla wielu tras w jednym żądaniu za pomocą punktu końcowego batchDelete.

Usuwanie trasy

Wyślij żądanie DELETE do punktu końcowego delete, aby usunąć wybraną trasę z projektu i zatrzymać zbieranie danych.

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

Żądanie musi zawierać numer projektu i name elementu SelectedRoute, który ma zostać usunięty.

Poniższy przykładowy kod pokazuje strukturę żądania DELETE do punktu końcowego 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"

W przypadku powodzenia interfejs API zwraca pusty obiekt JSON.

Usuwanie zbiorcze tras

Aby usunąć wiele tras w jednym żądaniu, użyj batchDelete punktu końcowego. Ten punkt końcowy umożliwia usunięcie do 1000 tras w jednym wywołaniu. Usuwanie zbiorcze jest niepodzielne: jeśli jakiekolwiek trasa w żądaniu zbiorczym nie zostanie usunięta lub będzie brakować, żadna trasa w zbiorze nie zostanie usunięta.

Wyślij żądanie POST do punktu końcowego batchDelete:

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

Treść żądania musi być obiektem JSON zawierającym tablicę names. Każdy element ciągu w tej tablicy to name elementu SelectedRoute, który ma zostać usunięty.

Poniższy przykładowy kod pokazuje strukturę żądania POST do punktu końcowego 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"

W przypadku powodzenia interfejs API zwraca pusty obiekt JSON. Zbieranie danych na usuniętej trasie zostanie natychmiast zatrzymane. Trwałe usuwanie zasobów odbywa się w tle i w przypadku dużych partii może potrwać kilka minut.

Aby sprawdzić stan trasy, użyj operacji get. Ponowienie żądania po zakończeniu trwałego usuwania zwraca błąd 404 Not Found, co potwierdza, że usuwanie zasobu zostało zakończone.