تعديل حقول المركبات

حقل حالة المركبة

يمكن للنظام ضبط حالة المركبة على OFFLINE أو ONLINE. على سبيل المثال، يمكنك ضبط حالة المركبة على ONLINE كل يوم في الساعة 9 صباحًا وOFFLINE كل يوم في الساعة 5 مساءً.

حقل سمات المركبات

استخدِم حقل المركبة attributes لإنشاء معايير مخصّصة تتيح للمستهلكين أو مشغّلي الأسطول العثور على المركبات في أسطولك من خلال مجموعة أوسع من معايير البحث. ويؤدي ذلك إلى تحسين إمكانات تطبيقاتك لتوفير مطابقات أفضل للمركبات مقارنةً بما يمكنك الحصول عليه من خلال استخدام معايير البحث التي تستند فقط إلى حقول المركبات الأخرى. يمكن أن تتضمّن كل مركبة 100 سمة كحد أقصى، ويجب أن يكون لكل سمة مفتاح فريد. يمكن أن تكون القيم سلاسل أو قيمًا منطقية أو أرقامًا.

على سبيل المثال، يمكنك تحديد سمة مخصّصة باسم الفئة لتمييز المركبات المشاركة في خدمة النقل العام على مستوى الفئات. يمكنك استخدام قيم السلاسل التالية لتمثيل مستويات فئة المركبات: ECONOMY وSTANDARD وLUXURY.

ومع ذلك، لا يجب أن تكون قيم السمات المخصّصة متعارضة مع بعضها. يمكنك استخدام معايير مثل السماح باصطحاب الحيوانات الأليفة وعدم التدخين وإمكانية إجراء رحلات أطول. ويمكن أن يكون كلٌّ منهما سمة مخصّصة منفصلة تستخدِم قيمًا منطقية. يمكن تخصيص كلّ السمات المخصّصة الثلاث هذه لمركبة معيّنة، بالإضافة إلى السمة المخصّصة class التي تم ضبطها على القيمة المناسبة للسلسلة.

يمكن أن يوفّر لك استخدام السمات بهذه الطريقة مجموعة كبيرة من الميزات المفيدة للعثور على المركبات للرحلات التي لها احتياجات معيّنة. للحصول على تعليمات حول كيفية استخدام السمات المخصّصة لفلترة طلبات البحث، يُرجى الاطّلاع على مقالة البحث عن المركبات.

تعديل سمات المركبات

يمكنك تعديل سمات المركبات باستخدام UpdateVehicle أو UpdateVehicleAttributes. يمكن أن يتضمّن كل مفتاح attributes قيمة واحدة فقط لكل مركبة. يمكنك الإفصاح عن سمات المركبات المخصّصة باستخدام attributes في قناع الحقل، ثم تقديم القيم استنادًا إلى الطريقة الموضّحة أدناه.

مثال على تعديل حقول المركبات

يوضّح هذا القسم كيفية تعديل حقول المركبات باستخدام UpdateVehicleRequest، التي تتضمّن update_mask للإشارة إلى الحقول التي يجب تعديلها. اطّلِع على مستندات Protocol Buffers حول أقنعة الحقول للاطّلاع على التفاصيل.

تتطلّب التعديلات على الحقول غير last_location امتيازات Fleet Engine On-demand المشرف.

مثال: تفعيل نوع الرحلة الجديد والسمة المخصّصة

يتيح هذا المثال back_to_back رحلة للمركبة ويحدّد أيضًا سمة جديدة: class. كما هو موضّح في مقالة تعديل سمات المركبات في وقت سابق، يتطلّب تعديل الحقل attributes باستخدام هذا النهج الإشارة إلى جميع السمات المخصّصة التي تريد الاحتفاظ بها. لذلك، يعرض المثال قيمة cash_only مكتوبة للحفاظ عليها من الكتابة فوقها أثناء عملية تعديل تحدد حقل attributes.

لتعديل قيمة زوج سمة مفتاح/قيمة واحد فقط، استخدِم الأسلوب UpdateVehicleAttributes بدلاً من ذلك ولا تُدرِج الحقل attribute في قناع الحقل لطلب UpdateVehicle.

اطّلِع على providers.vehicles.update مرجع gRPC وREST.

static final String PROJECT_ID = "project-id";
static final String VEHICLE_ID = "vid-8241890";

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;
Vehicle updatedVehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.ONLINE)
    .addAllAttributes(ImmutableList.of(
        VehicleAttribute.newBuilder().setKey("class").setValue("ECONOMY").build(),
        VehicleAttribute.newBuilder().setKey("cash_only").setValue("false").build()))
    .setBackToBackEnabled(true)
    .build();

UpdateVehicleRequest updateVehicleRequest = UpdateVehicleRequest.newBuilder()
    .setName(vehicleName)
    .setVehicle(updatedVehicle)
    .setUpdateMask(FieldMask.newBuilder()
        .addPaths("vehicle_state")
        .addPaths("attributes")
        .addPaths("back_to_back_enabled"))
    .build();

try {
  Vehicle updatedVehicle =
      vehicleService.updateVehicle(updateVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      // Most implementations will call CreateVehicle in this case
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}
// If no Exception, Vehicle updated successfully.

curl -X PUT \
  "https://fleetengine.googleapis.com/v1/providers/project-id/vehicles/vid-8241890?updateMask=vehicle_state,attributes,back_to_back_enabled" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  --data-binary @- << EOM
{
    "vehicleState": "ONLINE",
    "attributes": [
      {"key": "class", "value": "LUXURY"},
      {"key": "cash_only", "value": "false"}
    ],
    "backToBackEnabled": true
}
EOM

الخطوات التالية

• تعديل موقع مركبة