Delete selected routes

Auf dieser Seite wird beschrieben, wie Sie die Datenerhebung mit der Roads Selection API beenden:

  • Route löschen: Beenden Sie die Datenerhebung für eine einzelne Route mit dem Endpunkt delete.
  • Routen im Batch löschen: Mit dem Endpunkt batchDelete können Sie die Datenerhebung für mehrere Routen in einer einzigen Anfrage beenden.

Route löschen

Senden Sie eine DELETE-Anfrage an den Endpunkt delete, um eine ausgewählte Route aus Ihrem Projekt zu löschen und die Datenerhebung zu beenden.

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

Die Anfrage muss die Projektnummer und die name des zu löschenden SelectedRoute enthalten.

Das folgende Codebeispiel zeigt die Struktur einer DELETE-Anfrage an den Endpunkt 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"

Bei Erfolg gibt die API ein leeres JSON-Objekt zurück.

Routen im Batch löschen

Wenn Sie mehrere Routen in einer einzigen Anfrage löschen möchten, verwenden Sie den Endpunkt batchDelete. Mit diesem Endpunkt können Sie bis zu 1.000 Routen in einem Aufruf löschen. Das Löschen im Batch ist atomar: Wenn eine Route in der Batchanfrage fehlschlägt oder fehlt, werden keine Routen im Batch gelöscht.

Senden Sie eine POST-Anfrage an den Endpunkt batchDelete:

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

Der Anfragetext muss ein JSON-Objekt sein, das ein names-Array enthält. Jedes Stringelement in diesem Array ist der name einer zu löschenden SelectedRoute.

Das folgende Codebeispiel zeigt die Struktur einer POST-Anfrage an den Endpunkt 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"

Bei Erfolg gibt die API ein leeres JSON-Objekt zurück. Die Datenerhebung für die gelöschte Route wird sofort beendet. Das endgültige Löschen von Ressourcen wird im Hintergrund ausgeführt und kann bei großen Batches einige Minuten dauern.

Verwenden Sie den Vorgang get, um den Status Ihrer Route zu prüfen. Wenn Sie eine Anfrage nach dem endgültigen Löschen wiederholen, wird der Fehler 404 Not Found zurückgegeben. Das bedeutet, dass die Ressource gelöscht wurde.