Delete selected routes

Questa pagina descrive come interrompere la raccolta di dati utilizzando l'API Roads Selection:

  • Elimina una route: interrompi la raccolta di dati per una singola route utilizzando l' delete endpoint.
  • Elimina le route in batch: interrompi la raccolta di dati per più route in una singola richiesta utilizzando l'endpoint batchDelete.

Elimina una route

Invia una richiesta DELETE all'endpoint delete per eliminare una route selezionata dal tuo progetto e interrompere la raccolta di dati.

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

La richiesta deve includere il numero di progetto e il name del SelectedRoute da eliminare.

Il seguente esempio di codice mostra la struttura di una DELETE richiesta all' 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"

In caso di esito positivo, l'API restituisce un oggetto JSON vuoto.

Elimina le route in batch

Per eliminare più route in una singola richiesta, utilizza l' batchDelete endpoint. Questo endpoint ti consente di eliminare fino a 1000 route in una singola chiamata. L'eliminazione in batch è atomica: se una route nella richiesta batch non va a buon fine o è mancante, non viene eliminata alcuna route nel batch.

Invia una richiesta POST all'endpoint batchDelete:

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

Il corpo della richiesta deve essere un oggetto JSON contenente un array names. Ogni elemento stringa all'interno di questo array è il name di un SelectedRoute da eliminare.

Il seguente esempio di codice mostra la struttura di una POST richiesta all' 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"

In caso di esito positivo, l'API restituisce un oggetto JSON vuoto. La raccolta di dati sulla route eliminata si interrompe immediatamente. L'eliminazione permanente delle risorse viene completata in background e può richiedere alcuni minuti per i batch di grandi dimensioni.

Utilizza l' operazione get per controllare lo stato della route. Se riprovi a inviare una richiesta dopo che l'eliminazione permanente è stata completata, viene restituito un errore 404 Not Found, a conferma che l'eliminazione della risorsa è stata completata.