Delete selected routes

En esta página, se describe cómo detener la recopilación de datos con la API de Roads Selection:

  • Borra una ruta: Detén la recopilación de datos para una sola ruta con el extremo delete.
  • Borra rutas por lotes: Detén la recopilación de datos de varias rutas en una sola solicitud con el extremo batchDelete.

Borrar una ruta

Envía una solicitud DELETE al extremo delete para borrar una ruta seleccionada de tu proyecto y detener la recopilación de datos.

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

La solicitud debe incluir el número de proyecto y el name del SelectedRoute que se borrará.

En la siguiente muestra de código, se indica la estructura de una solicitud DELETE al extremo 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"

Si se realiza de forma correcta, la API devuelve un objeto JSON vacío.

Borra rutas por lotes

Para borrar varias rutas en una sola solicitud, usa el extremo batchDelete. Este extremo te permite borrar hasta 1,000 rutas en una sola llamada. La eliminación por lotes es atómica: si alguna ruta de la solicitud por lotes falla o falta, no se borra ninguna ruta del lote.

Envía una solicitud POST al extremo batchDelete:

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

El cuerpo de la solicitud debe ser un objeto JSON que contenga un array names. Cada elemento de cadena dentro de este array es el name de un SelectedRoute que se borrará.

En la siguiente muestra de código, se indica la estructura de una solicitud POST al extremo 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"

Si se realiza de forma correcta, la API devuelve un objeto JSON vacío. La recopilación de datos en la ruta borrada se detiene de inmediato. La eliminación permanente de recursos se completa en segundo plano y puede tardar unos minutos en completarse para lotes de gran tamaño.

Usa la operación get para verificar el estado de tu ruta. Si vuelves a intentar una solicitud después de que finalice la eliminación permanente, se mostrará un error 404 Not Found, lo que confirma que se completó la eliminación del recurso.