این سند نحوه ایجاد سفر پشتسرهم، تنظیم فیلدهای صحیح، و واگذاری آن به خودرو برای انجام را شرح میدهد. این راهنما فرض میکند که Fleet Engine را راهاندازی کردهاید، وسایل نقلیه را ایجاد کردهاید، برنامه راننده فعال دارید، و بهطور اختیاری، برنامه مصرفکننده دارید. همچنین باید با سناریوهای مختلف سفر موجود برای سفرهای درخواستی آشنا باشید. برای این کار، راهنماهای مرتبط زیر را ببینید:
- راهاندازی 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 | نه | شناسه خودرو اختصاصدادهشده به سفر. |
مثال: ایجاد سفر پشتسرهم
در زیر نحوه ایجاد سفر پشتسرهم و اختصاص آن به خودرو نشان داده شده است. در این سناریو، ایجاد سفر مانند سفر تکمقصدی است. فقط بعداً است که سفر دیگری ایجاد میکنید و آن را به خودرویی با سفر فعال اختصاص میدهید.
// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.setVehicleId(VEHICLE_ID)
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID)
.setTrip(trip)
.build();
// Error handling.
try {
// Fleet Engine automatically assigns a 'waypoints' list to the trip containing
// the vehicle's current trip waypoints.
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 بتواند زمان تخمینی رسیدن سفر را محاسبه و آن را ردیابی کند. میتوانید این کار را درطول ایجاد سفر یا بعداً هنگام بهروزرسانی سفر انجام دهید.
پساز اینکه سفر را به خودرو اختصاص دادید، Fleet Engine بهطور خودکار نقاط مسیر مرتبط با سفرهای پشتسرهم را به فیلد نقاط مسیر خودرو اضافه میکند. فیلد remainingWaypoints سفر حاوی فهرستی از همه نقطهمسیرها است، ازجمله نقطهمسیرهای سفرهای دیگری که قبلاز پیاده کردن مسافر این سفر بازدید خواهند شد.
برای مثال، دو سفر پشتسرهم را درنظر بگیرید: سفر الف و سفر ب. خودرو مصرفکننده را برای سفر الف سوار کرده است و درحین حرکت بهسمت مقصد، راننده درخواستی برای سوار کردن مصرفکننده دیگری برای سفر بعدی، سفر ب، دریافت میکند.
- فراخوانی
getVehicle()remainingWaypointsرا برمیگرداند که حاوی این موارد است:
A Drop-off ← B Pickup ← B Drop-off. -
getTrip()یاonTripRemainingWaypointsUpdatedفراخوانی برگشتی برای سفر الفremainingWaypointsرا برمیگرداند که حاوی این موارد است:
پیاده کردن الف. - یا
getTrip()یاonTripRemainingWaypointsUpdatedفراخوانی برگشتی برای سفر BremainingWaypointsرا برمیگرداند که حاوی این موارد است:
A پیاده کردن ← B سوار کردن ← و B پیاده کردن.