لإنشاء مركبة في Fleet Engine للرحلات عند الطلب، استخدِم نقطة النهاية CreateVehicle
مع CreateVehicleRequest
. تتطلّب نقطة النهاية هذه حسابًا يمتلك دور مشرف "محرك الأسطول" عند الطلب.
حقول المركبات للرحلات عند الطلب
عند إنشاء المركبات للرحلات عند الطلب، يجب ضبط الحقول المطلوبة. يجب أن تكون أيضًا على دراية بكيفية تأثير حقول المركبات معيّنة في وظائف أخرى في Fleet Engine. يُرجى الاطّلاع على تعديل حقول المركبات لمعرفة ذلك.
الحقول المطلوبة للرحلات عند الطلب
-
vehicle_state
: الإعداد التلقائي هو "غير معروف"، ولكن يجب ضبطه على "متصل" أو "غير متصل". اطّلِع على معلومات حول ضبط حقل حالة المركبة في مقالة تعديل حقول المركبات. -
supported_trip_types
: الإعداد التلقائي هو "غير معروف"، ولكن يجب ضبطه على مشترَك أو حصري أو كليهما. اطّلِع على أنواع الرحلات في دليل الرحلات عند الطلب للحصول على التفاصيل. -
maximum_capacity
: عدد الركاب الذين يمكن أن تنقلتهم المركبة، باستثناء السائق (بحكم التعريف). -
vehicle_type
: القيم هيAUTO
أوTAXI
أوTRUCK
أوTWO_WHEELER
أوBICYCLE
أوPEDESTRIAN
. يمكن استخدامها لفلترة المركبات في عمليات البحث عن المركبات. ويؤثّر ذلك أيضًا في وقت الوصول المقدَّر وعمليات احتساب المسار. يقدّم "محرّك الأسطول" مسارات وعمليات احتساب للسفر تتوافق مع أسلوب السفر استنادًا إلى مجموعات أنواع المركبات التالية:-
AUTO
أوTAXI
أوTRUCK
: على سبيل المثال، الطرق السريعة TWO_WHEELER
: على سبيل المثال، لن يتم عرض الطرق التي لا يُسمح فيها باستخدام المركبات ذات العجلتين.BICYCLE
: على سبيل المثال، مسارات الدراجاتPEDESTRIAN
: على سبيل المثال، الجسور والممرات المخصّصة للمشاة فقط
-
الحقول الأخرى
للاطّلاع على الحقول الأخرى التي يمكنك ضبطها عند إنشاء مركبة، يُرجى الاطّلاع على تعديل الحقول الخاصة بالمركبة.
مثال على إنشاء مركبة
القيمة المعروضة من CreateVehicle
هي عنصر Vehicle
الذي تم إنشاؤه.
Java
static final String PROJECT_ID = "project-id";
VehicleServiceBlockingStub vehicleService =
VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Vehicle vehicle = Vehicle.newBuilder()
.setVehicleState(VehicleState.OFFLINE) // Initial state
.addSupportedTripTypes(TripType.EXCLUSIVE)
.setMaximumCapacity(4)
.setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.addAttributes(VehicleAttribute.newBuilder()
.setKey("on_trip").setValue("false")) // Opaque to the Fleet Engine
// Add .setBackToBackEnabled(true) to make this vehicle eligible for trip
// matching while even if it is on a trip. By default this is disabled.
.build();
CreateVehicleRequest createVehicleRequest =
CreateVehicleRequest.newBuilder() // no need for the header
.setParent(parent)
.setVehicleId("vid-8241890") // Vehicle ID assigned by Rideshare or Delivery Provider
.setVehicle(vehicle) // Initial state
.build();
// In this case, the Vehicle is being created in the OFFLINE state and
// no initial position is being provided. When the Driver App checks
// in with the Rideshare or Delivery Provider, the state can be set to ONLINE and
// the Driver App will update the Vehicle Location.
try {
Vehicle createdVehicle =
vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
// If no Exception, Vehicle created successfully.
REST
curl -X POST \
"https://fleetengine.googleapis.com/v1/providers/project-id/vehicles?vehicleId=vid-8241890" \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
--data-binary @- << EOM
{
"vehicleState": "OFFLINE",
"supportedTripTypes": ["EXCLUSIVE"],
"maximumCapacity": 4,
"vehicleType": {"category": "AUTO"},
"attributes": [{"key": "on_trip", "value": "false"}]
}
EOM
راجِع مرجع providers.vehicles.create.