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

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

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

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

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

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

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

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

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

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

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

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

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

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

يتيح هذا المثال رحلات "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

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

• تعديل الموقع الجغرافي للمركبة