إنشاء مركبة توصيل للمهام المُجدوَلة

ملاحظة: قبل إنشاء طلب مركبة، اقرأ المتطلبات الواردة ضمن طلبات المركبات في المقدّمة:

يوضّح هذا المستند كيفية إنشاء مركبة من بيئة خادم باستخدام إما gRPC أو REST. يمكنك إنشاء مركبة من حزمة تطوير برامج Driver SDK، شرط أن تكون قد وفّرت التطبيق كبيئة موثوق بها باستخدام بيانات الاعتماد المناسبة.

لفهم كيفية استخدام "حزمة تطوير البرامج (SDK) للسائق" لإنشاء المركبات، يُرجى الاطّلاع على المراجع التالية:

• حزمة تطوير البرامج (SDK) لبرنامج التشغيل للمهام المُجدوَلة
• أدوار حساب الخدمة ضِمن أساسيات Fleet Engine.

لإنشاء مركبة جديدة من بيئة خادم، أنشِئ هناك طلب "CreateDeliveryVehicle" تم إرساله إلى Fleet Engine. استخدِم عنصر CreateDeliveryVehicleRequest لتحديد سمات مركبة التسليم الجديدة.

حقول المركبات المخصّصة للمهام المُجدوَلة

عند إنشاء DeliveryVehicle، عليك ضبط الحقول الاختيارية التالية:

• attributes
• last_location
• type

ملاحظة مهمة: لا تضبط أي حقول أخرى. وفي هذه الحالة، يعرض Fleet Engine خطأ لأنّ هذه الحقول إما للقراءة فقط أو لا يمكن تعديلها إلا من خلال طلب برمجي إلى UpdateDeliveryVehicle.

لإنشاء مركبة بدون ضبط أي حقول اختيارية، يمكنك مغادرة تم إلغاء ضبط الحقل DeliveryVehicle في CreateDeliveryVehicleRequest.

مثال على إنشاء مركبة

يمكنك استخدام مكتبة Java gRPC لإنشاء مركبة أو REST.

Java

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890"; // Avoid auto-incrementing IDs.

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String parent = "providers/" + PROJECT_ID;
  DeliveryVehicle vehicle = DeliveryVehicle.newBuilder()
    .addAttributes(DeliveryVehicleAttribute.newBuilder()
      .setKey("route_number").setValue("1"))  // Opaque to the Fleet Engine
    .build();

  // Vehicle request
  CreateDeliveryVehicleRequest createVehicleRequest =
    CreateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setDeliveryVehicleId(VEHICLE_ID)     // Vehicle ID assigned by the Provider
        .setDeliveryVehicle(vehicle)
        .build();

  // Error handling
  // If Fleet Engine does not have vehicle with that ID and the credentials of the
  // requestor pass, the service creates the vehicle successfully.

  try {
    DeliveryVehicle createdVehicle =
      deliveryService.createDeliveryVehicle(createVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

لإنشاء مركبة من بيئة خادم، يمكنك إجراء طلب HTTP REST إلى CreateDeliveryVehicle:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles?deliveryVehicleId=<id>

يمثّل نص POST كيان DeliveryVehicle الذي سيتم إنشاؤه. يمكنك تحديد الحقول الاختيارية التالية:

• attributes
• lastLocation
• type

  # Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
  # environment
  curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
  {
    "attributes": [{"key": "model", "value": "sedan"}],
    "lastLocation": {"location": {"latitude": 12.1, "longitude": 14.5}}
  }
  EOM

لإنشاء مركبة بدون ضبط أي حقول، اترك نص طلب POST فارغًا. وبعد ذلك تستخرج المركبة المنشأة حديثًا معرف مركبة من المعلمة deliveryVehicleId في عنوان URL الخاص بعملية POST.

مثال:

  # Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
  # environment
  curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}"

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

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