REST Resource: providers.deliveryVehicles

সম্পদ: ডেলিভারি যানবাহন

DeliveryVehicle যানবাহন বার্তা। একটি ডেলিভারি গাড়ি একটি ডিপো থেকে একটি ডেলিভারি অবস্থানে এবং একটি পিকআপ অবস্থান থেকে ডিপোতে চালান পরিবহন করে। কিছু ক্ষেত্রে, ডেলিভারি যানবাহনগুলি সরাসরি পিকআপ অবস্থান থেকে ডেলিভারি অবস্থানে চালান পরিবহন করে।

দ্রষ্টব্য: gRPC এবং REST APIগুলি বিভিন্ন ক্ষেত্রের নামকরণের রীতি ব্যবহার করে। উদাহরণস্বরূপ, gRPC API-এ DeliveryVehicle.current_route_segment ক্ষেত্র এবং REST API-এর DeliveryVehicle.currentRouteSegment ক্ষেত্র একই ক্ষেত্রকে নির্দেশ করে৷

JSON প্রতিনিধিত্ব 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "pastLocations": [
    {
      object (DeliveryVehicleLocation)
    }
  ],
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}
ক্ষেত্র
name

string

এই ডেলিভারি গাড়ির অনন্য নাম। ফরম্যাট হল providers/{provider}/deliveryVehicles/{vehicle} ।

lastLocation

object ( DeliveryVehicleLocation )

ডেলিভারি গাড়ির সর্বশেষ রিপোর্ট করা অবস্থান।

pastLocations[]

object ( DeliveryVehicleLocation )

শুধুমাত্র ইনপুট। যেসব অবস্থানে এই ডেলিভারি যানটি অতীতে ছিল যেগুলি এখনও ফ্লিট ইঞ্জিনে রিপোর্ট করা হয়নি। এটি UpdateDeliveryVehicleRequest এ ব্যবহৃত হয় এমন অবস্থান রেকর্ড করতে যা আগে সার্ভারে পাঠানো যায়নি। সাধারণত এটি ঘটে যখন ডেলিভারি গাড়িতে ইন্টারনেট সংযোগ থাকে না।

navigationStatus

enum ( DeliveryVehicleNavigationStatus )

ডেলিভারি গাড়ির নেভিগেশন অবস্থা।

currentRouteSegment

string ( bytes format)

এনকোড করা পলিলাইন সেই রুটটি নির্দিষ্ট করে যা নেভিগেশন পরবর্তী ওয়েপয়েন্টে যাওয়ার পরামর্শ দেয়। আপনার ড্রাইভার অ্যাপ এটি আপডেট করে যখন একটি স্টপে পৌঁছানো বা পাস করা হয়, এবং যখন নেভিগেশন পুনরায় রুট হয়। এই LatLng গুলিকে Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) বা Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)-এ ফেরত দেওয়া হয়।

কিছু ক্ষেত্রে এই ক্ষেত্রটি Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) বা Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

  • currentRouteSegment সেগমেন্টের শেষ পয়েন্ট DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) বা DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) ​​এর সাথে মেলে না।

  • ড্রাইভার অ্যাপটি সম্প্রতি তার অবস্থান আপডেট করেনি, তাই এই ক্ষেত্রের জন্য সর্বশেষ আপডেট করা মান পুরানো হতে পারে।

  • ড্রাইভার অ্যাপটি সম্প্রতি তার অবস্থান আপডেট করেছে, কিন্তু currentRouteSegment অচল, এবং পূর্ববর্তী গাড়ির থামার দিকে নির্দেশ করে।

এই ক্ষেত্রে, ফ্লিট ইঞ্জিন এই ক্ষেত্রটিকে অতি সম্প্রতি পাস করা VehicleStop থেকে আসন্ন VehicleStop পর্যন্ত একটি রুট দিয়ে পপুলেট করে যাতে এই ক্ষেত্রের গ্রাহকের কাছে ডেলিভারি যানের বর্তমান পথের সর্বোত্তম উপলব্ধ তথ্য রয়েছে তা নিশ্চিত করতে।

একটি base64-এনকোডেড স্ট্রিং।

currentRouteSegmentEndPoint

object ( LatLng )

currentRouteSegment যেখানে শেষ হয় সেই অবস্থান। এটি বর্তমানে ড্রাইভার অ্যাপ দ্বারা জনবহুল নয়, তবে আপনি এটি deliveryVehicles.patch কলে সরবরাহ করতে পারেন। এটি হয় আসন্ন গাড়ির স্টপ থেকে LatLng , অথবা currentRouteSegment শেষ LatLng । ফ্লিট ইঞ্জিন তখন একটি প্রকৃত VehicleStop ইন্টারপোলেট করার জন্য যথাসাধ্য চেষ্টা করবে।

currentRouteSegment ক্ষেত্রটি খালি থাকলে deliveryVehicles.patch কলগুলিতে এই ক্ষেত্রটিকে উপেক্ষা করা হয়৷

remainingDistanceMeters

integer

currentRouteSegment জন্য অবশিষ্ট ড্রাইভিং দূরত্ব। ড্রাইভার অ্যাপটি সাধারণত এই ক্ষেত্রটি প্রদান করে, তবে কিছু পরিস্থিতিতে রয়েছে যেখানে ফ্লিট ইঞ্জিন অ্যাপ দ্বারা প্রেরিত মানকে ওভাররাইড করবে। আরও তথ্যের জন্য, DeliveryVehicle.current_route_segment দেখুন। এই ক্ষেত্রটি ডেলিভারি গাড়ির জন্য নির্ধারিত সমস্ত সক্রিয় Task জন্য Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) বা Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) ​​এ ফেরত দেওয়া হয়।

currentRouteSegment ক্ষেত্র খালি থাকলে ফ্লিট ইঞ্জিন UpdateDeliveryVehicleRequest এ এই ক্ষেত্রটিকে উপেক্ষা করে।

remainingDuration

string ( Duration format)

currentRouteSegment জন্য অবশিষ্ট ড্রাইভিং সময়। ড্রাইভার অ্যাপটি সাধারণত এই ক্ষেত্রটি প্রদান করে, তবে কিছু পরিস্থিতিতে রয়েছে যেখানে ফ্লিট ইঞ্জিন অ্যাপ দ্বারা প্রেরিত মানকে ওভাররাইড করবে। আরও তথ্যের জন্য, DeliveryVehicle.current_route_segment দেখুন। এই ক্ষেত্রটি ডেলিভারি গাড়ির জন্য নির্ধারিত সমস্ত সক্রিয় কাজের জন্য Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) বা Task.remainingVehicleJourneySegments[0].drivingDuration (REST) ​​এ ফেরত দেওয়া হয়।

currentRouteSegment ক্ষেত্র খালি থাকলে ফ্লিট ইঞ্জিন UpdateDeliveryVehicleRequest এ এই ক্ষেত্রটিকে উপেক্ষা করে।

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

remainingVehicleJourneySegments[]

object ( VehicleJourneySegment )

এই ডেলিভারি গাড়ির জন্য নির্ধারিত যাত্রা বিভাগগুলি, যানবাহনের অতি সম্প্রতি রিপোর্ট করা অবস্থান থেকে শুরু করে। deliveryVehicles.list এর প্রতিক্রিয়ায় এই ক্ষেত্রটি পপুলেট করা হবে না।

attributes[]

object ( DeliveryVehicleAttribute )

কাস্টম ডেলিভারি গাড়ির বৈশিষ্ট্যগুলির একটি তালিকা৷ একটি ডেলিভারি গাড়ির সর্বাধিক 100টি বৈশিষ্ট্য থাকতে পারে এবং প্রতিটি বৈশিষ্ট্যের একটি অনন্য কী থাকতে হবে।

type

enum ( DeliveryVehicleType )

এই ডেলিভারি গাড়ির ধরন। সেট না থাকলে, এটি ডিফল্ট হবে AUTO ।

ডেলিভারি যানবাহন নেভিগেশন স্থিতি

গাড়ির নেভিগেশন স্ট্যাটাস।

Enums
UNKNOWN_NAVIGATION_STATUS অনির্দিষ্ট নেভিগেশন স্থিতি।
NO_GUIDANCE ড্রাইভার অ্যাপের নেভিগেশন FREE_NAV মোডে আছে।
ENROUTE_TO_DESTINATION টার্ন-বাই-টার্ন নেভিগেশন উপলব্ধ এবং ড্রাইভার অ্যাপ নেভিগেশন GUIDED_NAV মোডে প্রবেশ করেছে।
OFF_ROUTE গাড়িটি প্রস্তাবিত রুট ছেড়ে চলে গেছে।
ARRIVED_AT_DESTINATION গাড়িটি গন্তব্যের প্রায় 50 মিটারের মধ্যে।

DeliveryVehicleAttribute

একটি গাড়ির বৈশিষ্ট্যকে একটি মূল-মান জোড়া হিসাবে বর্ণনা করে। "কী:মান" স্ট্রিং দৈর্ঘ্য 256 অক্ষরের বেশি হতে পারে না।

JSON প্রতিনিধিত্ব 
{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}
ক্ষেত্র
key

string

বৈশিষ্ট্য এর কী.

value

string

বৈশিষ্ট্যের মান।

ইউনিয়ন ক্ষেত্র delivery_vehicle_attribute_value । অ্যাট্রিবিউটের মান, স্ট্রিং, বুল বা ডাবল টাইপের হতে পারে। delivery_vehicle_attribute_value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
stringValue

string

স্ট্রিং টাইপ করা বৈশিষ্ট্য মান.

দ্রষ্টব্য: এটি value ক্ষেত্রের অনুরূপ যা শেষ পর্যন্ত অবমূল্যায়িত হবে। পদ্ধতি তৈরি বা আপডেট করার জন্য, যেকোন একটি ক্ষেত্র ব্যবহার করা যেতে পারে, তবে stringValue ব্যবহার করার জন্য এটি দৃঢ়ভাবে সুপারিশ করা হয়। যদি stringValue এবং value উভয়ই সেট করা থাকে, তাহলে সেগুলি অবশ্যই অভিন্ন হতে হবে বা একটি ত্রুটি নিক্ষেপ করা হবে৷ উভয় ক্ষেত্র প্রতিক্রিয়ায় জনবহুল।

boolValue

boolean

বুলিয়ান টাইপ করা বৈশিষ্ট্য মান।

numberValue

number

ডাবল টাইপ করা বৈশিষ্ট্য মান.

ডেলিভারি যানবাহন প্রকার

ডেলিভারি গাড়ির ধরন।

Enums
DELIVERY_VEHICLE_TYPE_UNSPECIFIED মান অব্যবহৃত.
AUTO একটি অটোমোবাইল।
TWO_WHEELER একটি মোটরসাইকেল, মোপেড বা অন্যান্য দুই চাকার যান
BICYCLE মানব চালিত পরিবহন।
PEDESTRIAN একজন মানব পরিবহনকারী, সাধারণত হাঁটা বা দৌড়ানো, পথচারী পথ ধরে ভ্রমণ করে।

পদ্ধতি

create

 একটি নতুন DeliveryVehicle তৈরি করে এবং ফেরত দেয়।

delete

 ফ্লিট ইঞ্জিন থেকে একটি ডেলিভারি যান মুছে দেয়।

get

 নির্দিষ্ট DeliveryVehicle যানবাহনের উদাহরণ প্রদান করে।

list

 নির্দিষ্ট ফিল্টারিং মানদণ্ড পূরণ করে এমন সমস্ত DeliveryVehicle পায়৷

patch

 ফ্লিট ইঞ্জিনে আপডেট করা DeliveryVehicle ডেটা লেখে, এবং DeliveryVehicle কে Tasks অ্যাসাইন করে।