يصف هذا المستند كيفية إنشاء رحلة تجميع مشتركة، وتعيين الحقول الصحيحة، وتعيينها لمركبة لتنفيذها. من المفترض أنك أعددت FleetEngine وأنشأت مركبات ولديك تطبيق للسائقين جاهزين للعمل، فضلاً عن تطبيق للمستهلكين بشكل اختياري. ومن المفترض أيضًا أن تكون على دراية بسيناريوهات الرحلات المختلفة المتاحة للرحلات عند الطلب. اطّلِع على الأدلة ذات الصلة التالية لتحديد ما يلي:
- إعداد Fleet Engine
- إنشاء مركبة
- سيناريوهات الرحلات في النظرة العامة على الرحلات عند الطلب
أساسيات إنشاء الرحلات
يصف هذا القسم تفاصيل الطلب اللازمة لإنشاء رحلة في Fleet Engine. يمكنك إصدار طلب إنشاء باستخدام gRPC وREST.
حقول الرحلة
استخدِم الحقول التالية لإنشاء رحلة في Fleet Engine. يمكنك استخدام حقول مختلفة لأنواع مختلفة من الرحلات: رحلات فردية أو متعددة الوجهات أو رحلات متقاربة أو مشتركة. يمكنك توفير الحقول الاختيارية عند إنشاء الرحلة، أو يمكنك ضبطها لاحقًا عند تعديل الرحلة.
الاسم | مطلوب؟ | الوصف |
---|---|---|
أحد الوالدَين | نعم | سلسلة تتضمّن رقم تعريف المشروع يجب أن يكون هذا المعرّف هو المعرّف نفسه المستخدَم في عملية دمج Fleet Engine بالكامل، مع أدوار حساب الخدمة نفسها. |
trip_id | نعم | سلسلة تُنشئها وتُعرِّف هذه الرحلة بشكلٍ فريد تخضع معرّفات الرحلات لقيود معيّنة، كما هو موضّح في المرجع. |
trip_type | نعم | اضبط TripType على القيم التالية لنوع الرحلة التي تنشئها:
|
pickup_point | نعم | نقطة انطلاق الرحلة |
الوجهات المتوسطة المستوى | نعم | الرحلات متعددة الوجهات فقط: قائمة بالوجهات المتوسطة التي يزورها السائق بين موعد الاستلام والمغادرة. وكما هي الحال في |
vehicle_waypoints | نعم | رحلات التجميع المشترك فقط: يتيح هذا الحقل دمج نقاط الطريق من رحلات متعددة.
يحتوي هذا الملف على جميع نقاط التوقف المتبقية للمركبة المحدّدة، بالإضافة إلى
نقاط التوقف لتحميل الركاب وإيقافهم في هذه الرحلة. يمكنك ضبط هذا الحقل
من خلال الاتصال برقم |
number_of_passengers | لا | عدد الركاب على الرحلة. |
dropoff_point | لا | وجهة الرحلة. |
vehicle_id | لا | معرّف المركبة المحدّد للرحلة |
مثال: إنشاء رحلة تجميع مشتركة
يوضح نموذج دمج الخلفية التالي كيفية إنشاء رحلة وتخصيصها لمركبة كرحلة مشترَكة مشتركة.
// Vehicle with VEHICLE_ID ID is already created and it is assigned Trip A.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "shared-trip-A";
static final String VEHICLE_ID = "your-vehicle-id";
static final String TRIP_A_ID = "trip-a-id";
static final String TRIP_B_ID = "trip-b-id";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
LatLng tripBPickup =
LatLng.newBuilder().setLatitude(-12.12314).setLongitude(88.142123).build();
LatLng tripBDropoff =
LatLng.newBuilder().setLatitude(-14.12314).setLongitude(90.142123).build();
TerminalLocation tripBPickupTerminalLocation =
TerminalLocation.newBuilder().setPoint(tripBPickup).build();
TerminalLocation tripBDropoffTerminalLocation =
TerminalLocation.newBuilder().setPoint(tripBDropoff).build();
// TripA already exists and it's assigned to a vehicle with VEHICLE_ID ID.
Trip tripB = Trip.newBuilder()
.setTripType(TripType.SHARED)
.setVehicleId(VEHICLE_ID)
.setPickupPoint(tripBPickupTerminalLocation)
.setDropoffPoint(tripBDropoffTerminalLocation)
.addAllVehicleWaypoints(
// This is where you define the arrival order for unvisited waypoints.
// If you don't specify an order, then the Fleet Engine adds Trip B's
// waypoints to the end of Trip A's.
ImmutableList.of(
// Trip B's pickup point.
TripWaypoint.newBuilder()
.setLocation(tripBPickupTerminalLocation)
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
.build(),
// Trip A's drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripA.getDropoffPoint())
.setTripId(TRIP_A_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build(),
// Trip B's drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripBDropoffTerminalLocation)
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build()))
.build();
// Create Trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_B_ID)
.setTrip(tripB)
.build();
try {
// createdTrip.remainingWaypoints will contain shared-pool waypoints.
// [tripB.pickup, tripA.dropoff, tripB.dropoff]
Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
تعديل رحلات التجميع المشترَكة
يجب إسناد أي رحلة تم إنشاؤها في Fleet Engine إلى مركبة لكي تتمكّن أداة Fleet Engine من احتساب أوقات الوصول المقدَّرة للرحلات وتتبُّعها. يمكنك إجراء ذلك أثناء إنشاء الرحلة أو لاحقًا عند تعديلها.
بالنسبة إلى الرحلات المشترَكة، عليك تحديد ترتيب نقاط التوقف التي لم تتم زيارتها
في مجموعة نقاط التوقف للمركبة (Trip.vehicle_waypoints
) الخاصة بالرحلة. ويستخدم Fleet
Engine هذه القائمة لتعديل نقاط التوقف للرحلة تلقائيًا لجميع الرحلات
في المجموعة المشترَكة.
على سبيل المثال، فكّر في رحلتين مشترَكتين معًا، الرحلة أ والرحلة ب:
- الرحلة "أ" في طريقها إلى موقع الاستلام.
- تتم بعد ذلك إضافة الرحلة ب إلى المركبة نفسها.
في إحدى UpdateTripRequest
لرحلة ب،
يمكنك ضبط vehicleId
، وضبط Trip.vehicle_waypoints
أيضًا على الترتيب الأمثل
لنقاط المرور: ب نقطة الاستلام
→ أ نقطة الاستلام →
ب نقطة الاستلام.
- عند طلب الرقم
getVehicle()
، يتم إرجاعremainingWaypoints
تشمل ما يلي:
ب استلام الطلب ← الانسحاب ← ب المغادرة. - يمكن إما
getTrip()
أو استدعاءonTripRemainingWaypointsUpdated
للرحلة (أ) إرجاعremainingWaypoints
الذي يحتوي على:
ب استلام الطلب ← مغادرة. - إما
getTrip()
أو استدعاءonTripRemainingWaypointsUpdated
للرحلة ب يعرضremainingWaypoints
التي تتضمن:
ب استلام الطلب ← أ الانسحاب ← ب المغادرة.
مثال
يوضّح نموذج الدمج مع الخلفية التالي كيفية تعديل رحلة باستخدام رقم تعريف المركبة ونقاط الطريق لرحلتَين مشتركتَين.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_A_ID = "share-trip-A";
static final String TRIP_B_ID = "share-trip-B";
static final String VEHICLE_ID = "Vehicle";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_B_ID;
// Get Trip A and Trip B objects from either the Fleet Engine or storage.
Trip tripA = …;
Trip tripB = …;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to update.
Trip trip = Trip.newBuilder()
.setVehicleId(VEHICLE_ID)
.addAllVehicleWaypoints(
// This is where you define the arrival order for unvisited waypoints.
// If you don't specify an order, then the Fleet Engine adds Trip B's
// waypoints to the end of Trip A's.
ImmutableList.of(
// Trip B's pickup point.
TripWaypoint.newBuilder()
.setLocation(tripB.getPickupPoint())
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
.build(),
// Trip A's drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripA.getDropoffPoint())
.setTripId(TRIP_A_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build(),
// Trip B's drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripB.getDropoffPoint())
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build()))
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("vehicle_id")
.addPaths("vehicle_waypoints"))
.build();
// Error handling. If Fleet Engine has both a trip and vehicle with the IDs,
// and if the credentials validate, and if the given vehicle_waypoints list
// is valid, then the service updates the trip.
try {
Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // Either the trip or vehicle does not exist.
break;
case PERMISSION_DENIED:
break;
case INVALID_REQUEST: // vehicle_waypoints is invalid.
break;
}
return;
}