Delete selected routes

Na tej stronie dowiesz się, jak zatrzymać zbieranie danych za pomocą interfejsu Roads Selection API:

  • Usuwanie trasy: zatrzymaj zbieranie danych dla pojedynczej trasy za pomocą punktu końcowego delete.
  • Zbiorcze usuwanie 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 zasobu SelectedRoute, który chcesz usunąć.

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"

Jeśli operacja się powiedzie, interfejs API zwróci pusty obiekt JSON.

Usuwanie tras zbiorczo

Aby usunąć wiele tras w jednym żądaniu, użyj punktu końcowego batchDelete. Ten punkt końcowy umożliwia usunięcie maksymalnie 1000 tras w jednym wywołaniu. Usuwanie zbiorcze ma charakter niepodzielny: jeśli dowolna trasa w żądaniu zbiorczym nie powiedzie się lub jej brakuje, ż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 zasobu 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"

Jeśli operacja się powiedzie, interfejs API zwróci 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. Ponowna próba wysłania żądania po zakończeniu trwałego usunięcia zwraca błąd 404 Not Found, co potwierdza, że zasób został usunięty.