Questo documento descrive come eliminare un percorso. Si presuppone che tu abbia configurato Fleet Engine. Consulta Configura Fleet Engine.
Nozioni di base sull'eliminazione delle corse
Il tuo sistema potrebbe utilizzare Fleet Engine per eliminare una corsa nelle seguenti situazioni:
- Per eseguire operazioni di pulizia durante il test delle API Fleet Engine.
- Per eliminare immediatamente una corsa che non è più necessaria.
Per eliminare una corsa, invia una richiesta utilizzando gRPC o REST.
Utilizza le credenziali appropriate per il service account del tuo progetto, come descritto in Fleet Engine: ruoli dei service account.
Esempio: elimina corsa
L'esempio seguente mostra come eliminare una corsa in Fleet Engine.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
TripServiceBlockingStub tripService = TripServiceGrpc.newBlockingStub(channel);
// Delete trip request.
DeleteTripRequest deleteTripRequest = DeleteTripRequest.newBuilder()
.setName(tripName)
.build();
// Error handling.
try {
tripService.deleteTrip(deleteTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // The trip doesn't exist.
break;
case FAILED_PRECONDITION: // Trip is active and assigned to a vehicle.
break;
case PERMISSION_DENIED:
break;
}
return;
}
Gestisci gli errori
Quando elimini un percorso, potresti riscontrare un errore FAILED_PRECONDITION,
nel qual caso il percorso è attivo e assegnato a un veicolo.
Per procedere con l'eliminazione, chiama UpdateTrip e aggiorna trip_status
in COMPLETE/CANCELED.