নির্ধারিত কাজের জন্য একটি ডেলিভারি গাড়ি তৈরি করুন

এই ডকুমেন্টটিতে gRPC অথবা REST ব্যবহার করে সার্ভার এনভায়রনমেন্ট থেকে কীভাবে একটি যানবাহন তৈরি করতে হয়, তা বর্ণনা করা হয়েছে। আপনি ড্রাইভার SDK থেকে একটি যানবাহন তৈরি করতে পারবেন, তবে শর্ত হলো আপনাকে যথাযথ ক্রেডেনশিয়াল ব্যবহার করে অ্যাপটিকে একটি বিশ্বস্ত এনভায়রনমেন্ট হিসেবে প্রোভিশন করতে হবে।

ড্রাইভার এসডিকে ব্যবহার করে কীভাবে যানবাহন তৈরি করতে হয় তা বুঝতে, নিম্নলিখিত বিষয়গুলো দেখুন:

সার্ভার পরিবেশ থেকে একটি নতুন যানবাহন তৈরি করতে, Fleet Engine-এ একটি CreateDeliveryVehicle অনুরোধ পাঠান। নতুন ডেলিভারি যানবাহনটির বৈশিষ্ট্যগুলো নির্ধারণ করতে CreateDeliveryVehicleRequest অবজেক্টটি ব্যবহার করুন।

নির্ধারিত কাজের যানবাহনের জন্য ক্ষেত্র

DeliveryVehicle তৈরি করার সময়, আপনি নিম্নলিখিত ঐচ্ছিক ফিল্ডগুলো সেট করেন:

  • attributes
  • last_location
  • type

কোনো ঐচ্ছিক ফিল্ড সেট না করে একটি যানবাহন তৈরি করতে, আপনি CreateDeliveryVehicleRequest এ DeliveryVehicle ফিল্ডটি আনসেট রাখতে পারেন।

গাড়ির উদাহরণ তৈরি করুন

একটি যানবাহন তৈরি করতে, আপনি জাভা gRPC লাইব্রেরি অথবা 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;
  }

বিশ্রাম

সার্ভার পরিবেশ থেকে একটি যানবাহন তৈরি করতে, CreateDeliveryVehicle এ একটি HTTP REST কল করুন:

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 রিকোয়েস্টের বডি খালি রাখুন। এরপর নতুন তৈরি হওয়া যানবাহনটি POST URL-এ থাকা deliveryVehicleId প্যারামিটার থেকে একটি ভেহিকেল আইডি নিয়ে নেয়।

উদাহরণ:

  # 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}"

এরপর কী?