এই দস্তাবেজটি গুরুত্বপূর্ণ যানবাহন ক্ষেত্রগুলিকে কভার করে যা আপনি যানবাহন তৈরি এবং পরিচালনা করার সময় আপডেট করতে পারেন।
| গাড়ির ক্ষেত্রগুলির একটি সম্পূর্ণ তালিকার জন্য, দেখুন: |
যানবাহনের বৈশিষ্ট্যের ক্ষেত্র
আপনার ভোক্তা বা ফ্লিট অপারেটরদের বিভিন্ন ধরণের অনুসন্ধানের মানদণ্ড জুড়ে আপনার বহরে যানবাহন খুঁজে পেতে সক্ষম করার জন্য কাস্টমাইজ করা মানদণ্ড তৈরি করতে যানবাহনের attributes ক্ষেত্রটি ব্যবহার করুন। এটি শুধুমাত্র অন্যান্য যানবাহনের ক্ষেত্রের উপর ভিত্তি করে অনুসন্ধানের মানদণ্ড ব্যবহার করে আপনি যা করতে চান তার চেয়ে আরও ভাল যানবাহন মিল সরবরাহ করার জন্য এটি আপনার অ্যাপগুলির ক্ষমতা বাড়ায়। প্রতিটি গাড়ির সর্বাধিক 100টি বৈশিষ্ট্য থাকতে পারে এবং প্রতিটির একটি অনন্য কী থাকতে হবে। মান স্ট্রিং, বুলিয়ান বা সংখ্যা হতে পারে।
উদাহরণস্বরূপ, আপনি আপনার ডেলিভারি যানবাহনগুলি শহরের কোন অঞ্চলে কাজ করে তা আলাদা করতে আপনি জোন নামে একটি কাস্টম বৈশিষ্ট্য ঘোষণা করতে পারেন৷ আপনি বিভিন্ন অঞ্চলকে উপস্থাপন করতে নিম্নলিখিত স্ট্রিং মানগুলি ব্যবহার করবেন: 1B , 2C , এবং 3A ৷ তারপরে আপনি ফ্লিট ট্র্যাকিং-এ একটি ফিল্টার ব্যবহার করতে পারেন শুধুমাত্র সেই জোনের জন্য দায়ী অপারেটরকে একটি নির্দিষ্ট জোনে কাজ করা যানবাহন দেখানোর জন্য।
যাইহোক, কাস্টম বৈশিষ্ট্য মান পারস্পরিক একচেটিয়া হতে হবে না. আপনি উপলব্ধ-এ-রাতে এবং আছে-রেফ্রিজারেশনের মতো মানদণ্ড ব্যবহার করতে পারেন। এইগুলির প্রতিটি একটি পৃথক কাস্টম বৈশিষ্ট্য হতে পারে যা বুলিয়ান মান ব্যবহার করে। একটি প্রদত্ত গাড়িকে উপযুক্ত স্ট্রিং মান সেট করা জোন কাস্টম বৈশিষ্ট্য সহ এই তিনটি কাস্টম বৈশিষ্ট্য বরাদ্দ করা যেতে পারে।
গাড়ির বৈশিষ্ট্য আপডেট করুন
প্রতিটি attributes কী-এর প্রতি গাড়ির শুধুমাত্র একটি মান থাকতে পারে। আপনি ফিল্ড মাস্কের attributes ব্যবহার করে কাস্টম গাড়ির বৈশিষ্ট্যগুলি ঘোষণা করেন এবং তারপরে নীচের পদ্ধতির উপর ভিত্তি করে মান প্রদান করেন।
এই UpdateDeliveryVehicle API শুধুমাত্র একটি একক বৈশিষ্ট্য আপডেট করার অনুমতি দেয় না। এই পদ্ধতিটি ব্যবহার করার সময়, ফিল্ড মাস্কে attributes ফিল্ডের যেকোনো ব্যবহারের ফলে গাড়ির জন্য গাড়ির বৈশিষ্ট্যের সম্পূর্ণ সেট পুনরায় ঘোষণা করা হয়। এর ফলে ফিল্ড মাস্কে স্পষ্টভাবে অন্তর্ভুক্ত করা হয়নি এমন কোনো প্রাক-বিদ্যমান বৈশিষ্ট্যের একটি ওভাররাইট হয়ে যায়। আপনি যদি একটি নতুন কাস্টম অ্যাট্রিবিউট ঘোষণা করতে এই পদ্ধতিটি ব্যবহার করেন, তাহলে আপনাকে অবশ্যই গাড়িটিকে ধরে রাখতে চান এমন প্রতিটি কাস্টম বৈশিষ্ট্য পুনরায় ঘোষণা করতে হবে। আপনি যদি ফিল্ড মাস্কের attributes বাদ দেন, তাহলে এই পদ্ধতিটি গাড়ির জন্য পূর্বে সংজ্ঞায়িত হিসাবে বিদ্যমান কাস্টম বৈশিষ্ট্যগুলিকে ছেড়ে দেয়। আপনি যদি ফিল্ড মাস্কে attributes ব্যবহার করেন, কিন্তু মান সেট না করেই, সেটা গাড়ি থেকে সমস্ত কাস্টম অ্যাট্রিবিউট মুছে ফেলার সমতুল্য।
গাড়ির ক্ষেত্রের উদাহরণ আপডেট করুন
এই বিভাগটি দেখায় কিভাবে UpdateDeliveryVehicleRequest ব্যবহার করে যানবাহনের ক্ষেত্রগুলি আপডেট করতে হয়, যেটি আপডেট করতে হবে তা নির্দেশ করার জন্য একটি update_mask অন্তর্ভুক্ত। বিস্তারিত জানার জন্য ফিল্ড মাস্কের প্রোটোকল বাফার ডকুমেন্টেশন দেখুন।
last_location ব্যতীত অন্য ক্ষেত্রগুলির আপডেটের জন্য Fleet Engine Delivery Admin বিশেষাধিকার প্রয়োজন৷
উদাহরণ: কাস্টম বৈশিষ্ট্য সেট করুন
এই উদাহরণটি একটি নতুন বৈশিষ্ট্য নির্দিষ্ট করে: zone । যেমন আগে আপডেট গাড়ির বৈশিষ্ট্যগুলিতে উল্লেখ করা হয়েছে, এই পদ্ধতি ব্যবহার করে attributes ক্ষেত্র আপডেট করার জন্য আপনাকে সমস্ত কাস্টম বৈশিষ্ট্যগুলিকে নির্দেশ করতে হবে যা আপনি ধরে রাখতে চান। তাই উদাহরণটি একটি available-at-night মান দেখায় যা একটি আপডেট অপারেশনের সময় এটিকে ওভাররাইট করা থেকে রক্ষা করার জন্য লেখা হয়েছে যা attributes ক্ষেত্রটি নির্দিষ্ট করে।
providers.deliveryVehicles.patch রেফারেন্স দেখুন।
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
.addAllAttributes(ImmutableList.of(
DeliveryVehicleAttribute.newBuilder().setKey("zone").setValue("1B").build(),
DeliveryVehicleAttribute.newBuilder().setKey("available-at-night").setValue("true").build()))
.build();
// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
UpdateDeliveryVehicleRequest.newBuilder() // No need for the header
.setName(vehicleName)
.setDeliveryVehicle(myDeliveryVehicle)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("attributes"))
.build();
try {
DeliveryVehicle updatedDeliveryVehicle =
deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
বিশ্রাম
# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=attributes" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"attributes": [
{"key": "zone", "value": "1B"},
{"key": "available-at-night", "value": "true"}
]
}
EOM