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

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

لفهم كيفية استخدام Driver SDK لإنشاء المركبات، يُرجى الاطّلاع على ما يلي:

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

حقول مركبات المهام المجدولة

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

  • attributes
  • last_location
  • type

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

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

لإنشاء مركبة، يمكنك استخدام الـ Java gRPC library أو REST. للاطّلاع على القائمة الكاملة باللغات المتاحة، يُرجى الانتقال إلى مكتبات العملاء لخدمات المهام المجدولة.

جافا

  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;
  }

راحة

لإنشاء مركبة من بيئة خادم، عليك إجراء طلب 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}"

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