מחיקת הנסיעה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במאמר הזה מוסבר איך למחוק נסיעה. ההנחה היא שהגדרתם את Fleet Engine. מידע נוסף מופיע במאמר בנושא הגדרת Fleet Engine.
היסודות של מחיקת נסיעות
יכול להיות שהמערכת שלכם תשתמש ב-Fleet Engine כדי למחוק נסיעה במצבים הבאים:
- כדי לבצע פעולות ניקוי בזמן בדיקת ממשקי Fleet Engine API.
- כדי למחוק באופן מיידי נסיעה שכבר לא נדרשת.
כדי למחוק נסיעה, שולחים בקשה באמצעות gRPC או REST.
- שיטה:
DeleteTrip()
gRPC או REST
- הודעה
DeleteTripRequest
: gRPC בלבד
משתמשים בפרטי הכניסה המתאימים לחשבון השירות של הפרויקט, כפי שמתואר במאמר Fleet Engine: תפקידים בחשבון שירות.
דוגמה: מחיקת הנסיעה
בדוגמה הבאה מוסבר איך למחוק נסיעה ב-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;
}
טיפול בשגיאות
כשמוחקים נסיעה, יכול להיות שתיתקלו בשגיאה FAILED_PRECONDITION
. במקרה כזה, הנסיעה פעילה ומשויכת לרכב.
כדי להמשיך במחיקה, צריך להתקשר אל UpdateTrip
ולעדכן את trip_status
לCOMPLETE
/CANCELED
.
המאמרים הבאים
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-09-04 (שעון UTC).
[null,null,["עדכון אחרון: 2025-09-04 (שעון UTC)."],[],[],null,["This document describes how to delete a trip. It assumes you\nhave set up Fleet Engine. See [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n\nTrip deletion basics\n\nYour system may use Fleet Engine to delete a trip in the following situations:\n\n- To perform cleanup operations while testing Fleet Engine APIs.\n- To immediately delete a Trip that is no longer required.\n\nTo delete a trip, send a request using either gRPC or REST.\n\n- `DeleteTrip()` method: [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#maps.fleetengine.v1.TripService) or [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips/delete)\n- `DeleteTripRequest` message: [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#deletetriprequest) only\n\nUse the appropriate credentials for the service account of your project as\ndescribed in [Fleet Engine: Service account roles](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/service-accounts).\n| **Note:** Fleet Engine automatically deletes a trip after it has been inactive for a period of time. See [Life of a trip](/maps/documentation/mobility/fleet-engine/journeys/trips#life_of_a_trip).\n\nExample: delete trip\n\nThe following example demonstrates how to delete a trip in Fleet Engine. \n\n static final String PROJECT_ID = \"my-rideshare-co-gcp-project\";\n static final String TRIP_ID = \"trip-8241890\";\n\n String tripName = \"providers/\" + PROJECT_ID + \"/trips/\" + TRIP_ID;\n\n TripServiceBlockingStub tripService = TripServiceGrpc.newBlockingStub(channel);\n\n // Delete trip request.\n DeleteTripRequest deleteTripRequest = DeleteTripRequest.newBuilder()\n .setName(tripName)\n .build();\n\n // Error handling.\n try {\n tripService.deleteTrip(deleteTripRequest);\n } catch (StatusRuntimeException e) {\n Status s = e.getStatus();\n switch (s.getCode()) {\n case NOT_FOUND: // The trip doesn't exist.\n break;\n case FAILED_PRECONDITION: // Trip is active and assigned to a vehicle.\n break;\n case PERMISSION_DENIED:\n break;\n }\n return;\n }\n\nHandle errors\n\nWhen deleting a trip, you might encounter a `FAILED_PRECONDITION` error,\nin which case the trip is active and assigned to a vehicle. \n\nTo proceed with the deletion, call `UpdateTrip` and update the `trip_status`\nto `COMPLETE`/`CANCELED`.\n\nWhat's next\n\n- [Create multi-destination trips](/maps/documentation/mobility/fleet-engine/journeys/trips/multi-destination)"]]