Esta página descreve como interromper a coleta de dados usando a API Roads Selection:
- Excluir uma rota: interrompa a coleta de dados de uma única rota usando o endpoint
delete. - Excluir rotas em lote: interrompa a coleta de dados de várias rotas em
uma única solicitação usando o endpoint
batchDelete.
Excluir uma rota
Envie uma solicitação DELETE para o endpoint delete para excluir uma rota selecionada
do projeto e interromper a coleta de dados.
https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID
A solicitação precisa incluir o número do projeto e o name do
SelectedRoute a ser excluída.
O exemplo de código a seguir mostra a estrutura de uma solicitação DELETE para o
delete endpoint:
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"
Se a operação for bem-sucedida, a API retornará um objeto JSON vazio.
Excluir rotas em lote
Para excluir várias rotas em uma única solicitação, use o
batchDelete
endpoint. Esse endpoint permite excluir até 1.000 rotas em uma chamada. A exclusão em lote é atômica: se alguma rota na solicitação em lote falhar ou estiver ausente, nenhuma rota no lote será excluída.
Envie uma solicitação POST para o batchDelete endpoint:
https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes:batchDelete
O corpo da solicitação precisa ser um objeto JSON que contenha uma matriz names.
Cada elemento de string nessa matriz é o name de um
SelectedRoute a ser excluído.
O exemplo de código a seguir mostra a estrutura de uma solicitação POST para o
batchDelete endpoint:
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"Se a operação for bem-sucedida, a API retornará um objeto JSON vazio. A coleta de dados na rota excluída é interrompida imediatamente. A exclusão permanente de recursos é concluída em segundo plano e pode levar alguns minutos para ser concluída em lotes grandes.
Use a operação
get
para verificar o status da rota. Tentar novamente uma solicitação após a exclusão permanente retorna um erro 404 Not Found, confirmando que a exclusão do recurso foi concluída.