REST Resource: providers.tasks

সম্পদ: টাস্ক

ডেলিভারি API-এ একটি টাস্ক ট্র্যাক করার জন্য একটি একক অ্যাকশন উপস্থাপন করে। সাধারণভাবে, শিপমেন্ট-সম্পর্কিত টাস্ক এবং ব্রেক টাস্কের মধ্যে একটি পার্থক্য রয়েছে। একটি চালানের সাথে যুক্ত একাধিক টাস্ক থাকতে পারে। উদাহরণস্বরূপ, পিকআপের জন্য একটি কাজ হতে পারে এবং একটি ড্রপ-অফ বা স্থানান্তরের জন্য। এছাড়াও, একটি প্রদত্ত চালানের জন্য বিভিন্ন টাস্ক বিভিন্ন যানবাহন দ্বারা পরিচালনা করা যেতে পারে। উদাহরণস্বরূপ, একটি যানবাহন পিকআপ পরিচালনা করতে পারে, চালানটিকে হাবের দিকে নিয়ে যেতে পারে, যখন অন্য যানবাহন হাব থেকে ড্রপ-অফ অবস্থানে একই চালান চালায়।

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

JSON প্রতিনিধিত্ব
{
  "name": string,
  "type": enum (Type),
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfo)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSource),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "journeySharingInfo": {
    object (JourneySharingInfo)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfig)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}
ক্ষেত্র
name

string

ফর্ম্যাট providers/{provider}/tasks/{task} হতে হবে।

type

enum ( Type )

প্রয়োজন। অপরিবর্তনীয়। টাস্কের ধরন নির্ধারণ করে। উদাহরণস্বরূপ, একটি বিরতি বা চালান।

state

enum ( State )

প্রয়োজন। টাস্কের বর্তমান নির্বাহের অবস্থা।

taskOutcome

enum ( TaskOutcome )

টাস্কের ফলাফল।

taskOutcomeTime

string ( Timestamp format)

টাইমস্ট্যাম্প যা নির্দেশ করে কখন Task ফলাফল প্রদানকারী দ্বারা সেট করা হয়েছিল৷

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z"

taskOutcomeLocation

object ( LocationInfo )

যে অবস্থানে Task ফলাফল সেট করা হয়েছিল। এই মানটি tasks.patch এর অংশ হিসাবে আপডেট করা হয়েছে। যদি এই মানটি প্রদানকারীর দ্বারা স্পষ্টভাবে আপডেট করা না হয়, তাহলে ফ্লিট ইঞ্জিন এটিকে শেষ পরিচিত গাড়ির অবস্থান ( কাঁচা অবস্থান) দিয়ে ডিফল্টরূপে পূরণ করে।

taskOutcomeLocationSource

enum ( TaskOutcomeLocationSource )

taskOutcomeLocation মান কোথা থেকে এসেছে তা নির্দেশ করে।

trackingId

string

অপরিবর্তনীয়। এই ক্ষেত্রটি একটি আইডি সংরক্ষণের সুবিধা দেয় যাতে আপনি একটি জটিল ম্যাপিং ব্যবহার এড়াতে পারেন। আপনি UNAVAILABLE এবং SCHEDULED_STOP ধরনের টাস্কের জন্য trackingId সেট করতে পারবেন না। এই আইডিগুলি নিম্নলিখিত বিধিনিষেধ সাপেক্ষে:

  • একটি বৈধ ইউনিকোড স্ট্রিং হতে হবে।
  • সর্বাধিক 64 অক্ষরের দৈর্ঘ্যে সীমাবদ্ধ।
  • ইউনিকোড নরমালাইজেশন ফর্ম সি অনুযায়ী স্বাভাবিক করা হয়েছে।
  • নিম্নলিখিত ASCII অক্ষরগুলির মধ্যে কোনও নাও থাকতে পারে: '/', ':', '?', ',', বা '#'৷
deliveryVehicleId

string

শুধুমাত্র আউটপুট। যে গাড়িটি এই কাজটি সম্পাদন করছে তার আইডি। ডেলিভারি যানবাহন আইডি নিম্নলিখিত বিধিনিষেধ সাপেক্ষে:

  • একটি বৈধ ইউনিকোড স্ট্রিং হতে হবে।
  • সর্বাধিক 64 অক্ষরের দৈর্ঘ্যে সীমাবদ্ধ।
  • ইউনিকোড নরমালাইজেশন ফর্ম সি অনুযায়ী স্বাভাবিক করা হয়েছে।
  • নিম্নলিখিত ASCII অক্ষরগুলির মধ্যে কোনও নাও থাকতে পারে: '/', ':', '?', ',', বা '#'৷
plannedLocation

object ( LocationInfo )

অপরিবর্তনীয়। যে অবস্থানে টাস্ক সম্পন্ন হবে। UNAVAILABLE কাজগুলির জন্য ঐচ্ছিক, কিন্তু অন্যান্য সমস্ত কাজের জন্য প্রয়োজনীয়৷

taskDuration

string ( Duration format)

প্রয়োজন। অপরিবর্তনীয়। এই অবস্থানে একটি টাস্ক চালানোর জন্য প্রয়োজনীয় সময়।

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

targetTimeWindow

object ( TimeWindow )

টাইম উইন্ডো যে সময়ে কাজটি সম্পন্ন করা উচিত।

journeySharingInfo

object ( JourneySharingInfo )

শুধুমাত্র আউটপুট। জার্নি শেয়ারিং-নির্দিষ্ট ক্ষেত্র। যখন রাজ্য CLOSED থাকে তখন জনবহুল হয় না।

taskTrackingViewConfig

object ( TaskTrackingViewConfig )

টাস্ক ট্র্যাকিংয়ের কনফিগারেশন যা নির্দিষ্ট করে যে কোন পরিস্থিতিতে কোন ডেটা উপাদানগুলি শেষ ব্যবহারকারীদের কাছে দৃশ্যমান।

attributes[]

object ( TaskAttribute )

কাস্টম টাস্ক বৈশিষ্ট্যের একটি তালিকা। প্রতিটি বৈশিষ্ট্যের একটি অনন্য কী থাকতে হবে।

টাইপ

টাস্কের ধরন।

Enums
TYPE_UNSPECIFIED ডিফল্ট, টাস্ক টাইপ অজানা।
PICKUP একটি পিকআপ টাস্ক হল একটি গ্রাহকের কাছ থেকে একটি চালান তোলার জন্য নেওয়া পদক্ষেপ। ডিপো বা ফিডার গাড়ির পিকআপগুলিকে SCHEDULED_STOP প্রকার ব্যবহার করা উচিত৷
DELIVERY একটি ডেলিভারি টাস্ক হল শেষ গ্রাহকের কাছে একটি চালান সরবরাহ করার জন্য নেওয়া পদক্ষেপ। ডিপো বা ফিডার গাড়ির ড্রপঅফগুলি SCHEDULED_STOP প্রকার ব্যবহার করা উচিত৷
SCHEDULED_STOP পরিকল্পনার উদ্দেশ্যে একটি নির্ধারিত স্টপ টাস্ক ব্যবহার করা হয়। উদাহরণস্বরূপ, এটি ফিডার যানবাহন বা ডিপো থেকে শিপমেন্ট তোলা বা ড্রপ বন্ধের প্রতিনিধিত্ব করতে পারে। এটি এমন কোনো চালানের জন্য ব্যবহার করা উচিত নয় যা শেষ গ্রাহকের কাছ থেকে তোলা বা ফেলে দেওয়া হয়।
UNAVAILABLE একটি টাস্ক মানে যানবাহন পরিষেবার জন্য উপলব্ধ নয়৷ উদাহরণস্বরূপ, যখন ড্রাইভার বিরতি নেয়, বা যখন গাড়িতে জ্বালানি দেওয়া হয় তখন এটি ঘটতে পারে।

TaskOutcomeLocationSource

যে উৎসের পরিচয় taskOutcomeLocation তৈরি করেছে।

Enums
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED এটা সেট করার আগে টাস্ক ফলাফল.
PROVIDER প্রদানকারী taskOutcomeLocation নির্দিষ্ট করেছে।
LAST_VEHICLE_LOCATION প্রদানকারী taskOutcomeLocation নির্দিষ্ট করেনি, তাই ফ্লিট ইঞ্জিন সর্বশেষ পরিচিত গাড়ির অবস্থান ব্যবহার করেছে।

জার্নি শেয়ারিং ইনফো

জার্নি শেয়ারিং নির্দিষ্ট ক্ষেত্র.

JSON প্রতিনিধিত্ব
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "lastLocationSnappable": boolean
}
ক্ষেত্র
remainingVehicleJourneySegments[]

object ( VehicleJourneySegment )

এই টাস্কটি সম্পূর্ণ করার আগে নির্ধারিত গাড়িটি যে স্টপগুলি তৈরি করবে তার জন্য ট্র্যাকিং তথ্য। মনে রাখবেন এই তালিকায় অন্যান্য কাজের স্টপ থাকতে পারে।

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

lastLocation

object ( DeliveryVehicleLocation )

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

lastLocationSnappable

boolean

গাড়ির শেষ অবস্থান currentRouteSegment স্ন্যাপ করা যাবে কিনা তা নির্দেশ করে৷ যদি lastLocation বা currentRouteSegment বিদ্যমান না থাকে তবে এই মানটি মিথ্যা। এই মানটি ফ্লিট ইঞ্জিন দ্বারা গণনা করা হয়। ক্লায়েন্টদের থেকে আপডেট উপেক্ষা করা হয়.

TaskTrackingViewConfig

কনফিগারেশন বার্তা যেটি নির্ধারণ করে কখন একটি টাস্কের ডেটা উপাদান শেষ ব্যবহারকারীদের কাছে দৃশ্যমান হবে।

JSON প্রতিনিধিত্ব
{
  "routePolylinePointsVisibility": {
    object (VisibilityOption)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOption)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOption)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOption)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOption)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOption)
  }
}
ক্ষেত্র
routePolylinePointsVisibility

object ( VisibilityOption )

যে ক্ষেত্রটি নির্দিষ্ট করে কখন রুট পলিলাইন পয়েন্টগুলি দৃশ্যমান হতে পারে৷ এই ক্ষেত্রটি নির্দিষ্ট করা না থাকলে, এই ডেটার জন্য প্রকল্প স্তরের ডিফল্ট দৃশ্যমানতা কনফিগারেশন ব্যবহার করা হবে।

estimatedArrivalTimeVisibility

object ( VisibilityOption )

আনুমানিক আগমনের সময় দৃশ্যমান হতে পারে এমন ক্ষেত্রটি নির্দিষ্ট করে। এই ক্ষেত্রটি নির্দিষ্ট করা না থাকলে, এই ডেটার জন্য প্রকল্প স্তরের ডিফল্ট দৃশ্যমানতা কনফিগারেশন ব্যবহার করা হবে।

estimatedTaskCompletionTimeVisibility

object ( VisibilityOption )

যে ক্ষেত্রটি নির্দিষ্ট করে কখন আনুমানিক টাস্ক সমাপ্তির সময় দৃশ্যমান হতে পারে। এই ক্ষেত্রটি নির্দিষ্ট করা না থাকলে, এই ডেটার জন্য প্রকল্প স্তরের ডিফল্ট দৃশ্যমানতা কনফিগারেশন ব্যবহার করা হবে।

remainingDrivingDistanceVisibility

object ( VisibilityOption )

ড্রাইভিং দূরত্ব অবশিষ্ট থাকার সময় যে ক্ষেত্রটি নির্দিষ্ট করে তা দৃশ্যমান হতে পারে। এই ক্ষেত্রটি নির্দিষ্ট করা না থাকলে, এই ডেটার জন্য প্রকল্প স্তরের ডিফল্ট দৃশ্যমানতা কনফিগারেশন ব্যবহার করা হবে।

remainingStopCountVisibility

object ( VisibilityOption )

যে ক্ষেত্রটি নির্দিষ্ট করে যখন স্টপ গণনা অবশিষ্ট থাকে তা দৃশ্যমান হতে পারে। এই ক্ষেত্রটি নির্দিষ্ট করা না থাকলে, এই ডেটার জন্য প্রকল্প স্তরের ডিফল্ট দৃশ্যমানতা কনফিগারেশন ব্যবহার করা হবে।

vehicleLocationVisibility

object ( VisibilityOption )

যে ক্ষেত্রটি নির্দিষ্ট করে কখন গাড়ির অবস্থান দৃশ্যমান হতে পারে৷ এই ক্ষেত্রটি নির্দিষ্ট করা না থাকলে, এই ডেটার জন্য প্রকল্প স্তরের ডিফল্ট দৃশ্যমানতা কনফিগারেশন ব্যবহার করা হবে।

দৃশ্যমানতা বিকল্প

বিকল্প বার্তা যা নির্ধারণ করে কখন একটি ডেটা উপাদান শেষ ব্যবহারকারীদের কাছে দৃশ্যমান হবে।

JSON প্রতিনিধিত্ব
{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্রের visibility_option । নির্দিষ্ট দৃশ্যমানতার বিকল্পটি বেছে নেওয়া হয়েছে। visibility_option নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
remainingStopCountThreshold

integer

এই ডেটা উপাদানটি শেষ ব্যবহারকারীদের কাছে দৃশ্যমান হয় যদি অবশিষ্ট স্টপ গণনা <= leftingStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string ( Duration format)

এই ডেটা উপাদানটি শেষ ব্যবহারকারীদের কাছে দৃশ্যমান হয় যদি স্টপ থেকে ETA <= durationUntilEstimatedArrivalTimeThreshold.

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

remainingDrivingDistanceMetersThreshold

integer

এই ডেটা উপাদানটি শেষ ব্যবহারকারীদের কাছে দৃশ্যমান হয় যদি মিটারে অবশিষ্ট ড্রাইভিং দূরত্ব <= বাকি ড্রাইভিংডিসটেন্সমিটার থ্রেশহোল্ড।

always

boolean

সত্য হিসাবে সেট করা হলে, এই ডেটা উপাদানটি সর্বদা শেষ ব্যবহারকারীদের কাছে কোন থ্রেশহোল্ড ছাড়াই দৃশ্যমান হয়৷ এই ক্ষেত্র মিথ্যা সেট করা যাবে না.

never

boolean

সত্য হিসাবে সেট করা হলে, এই ডেটা উপাদানটি সর্বদা শেষ ব্যবহারকারীদের থেকে কোন থ্রেশহোল্ড ছাড়াই লুকানো থাকে। এই ক্ষেত্র মিথ্যা সেট করা যাবে না.

পদ্ধতি

batchCreate

নতুন Task অবজেক্টের একটি ব্যাচ তৈরি করে এবং ফেরত দেয়।

create

একটি নতুন Task অবজেক্ট তৈরি করে এবং ফেরত দেয়।

get

একটি Task সম্পর্কে তথ্য পায়।

list

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

patch

Task ডেটা আপডেট করে।