Package maps.fleetengine.delivery.v1

সূচক

বিতরণ সেবা

লাস্ট মাইল ডেলিভারি সার্ভিস।

BatchCreateTasks

rpc BatchCreateTasks( BatchCreateTasksRequest ) returns ( BatchCreateTasksResponse )

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

ডেলিভারি যান তৈরি করুন

rpc CreateDeliveryVehicle( CreateDeliveryVehicleRequest ) returns ( DeliveryVehicle )

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

টাস্ক তৈরি করুন

rpc CreateTask( CreateTaskRequest ) returns ( Task )

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

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

rpc GetDeliveryVehicle( GetDeliveryVehicleRequest ) returns ( DeliveryVehicle )

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

GetTask

rpc GetTask( GetTaskRequest ) returns ( Task )

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

GetTaskTrackingInfo

rpc GetTaskTrackingInfo( GetTaskTrackingInfoRequest ) returns ( TaskTrackingInfo )

নির্দিষ্ট TaskTrackingInfo উদাহরণ প্রদান করে।

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

rpc ListDeliveryVehicles( ListDeliveryVehiclesRequest ) returns ( ListDeliveryVehiclesResponse )

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

তালিকা টাস্ক

rpc ListTasks( ListTasksRequest ) returns ( ListTasksResponse )

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

ডেলিভারি যানবাহন আপডেট করুন

rpc UpdateDeliveryVehicle( UpdateDeliveryVehicleRequest ) returns ( DeliveryVehicle )

ফ্লিট ইঞ্জিনে আপডেট করা DeliveryVehicle ডেটা লেখে, এবং DeliveryVehicle কে Tasks অ্যাসাইন করে। আপনি DeliveryVehicle এর নাম আপডেট করতে পারবেন না। আপনি remaining_vehicle_journey_segments আপডেট করতে পারেন , তবে DeliveryVehicle টিকে থাকার জন্য এটিতে অবশ্যই সমস্ত VehicleJourneySegment থাকতে হবে। task_id remaining_vehicle_journey_segments থেকে পুনরুদ্ধার করা হয়েছে, এবং তাদের সংশ্লিষ্ট Tasks DeliveryVehicle বরাদ্দ করা হয়েছে যদি সেগুলি এখনও বরাদ্দ না করা হয়।

আপডেট টাস্ক

rpc UpdateTask( UpdateTaskRequest ) returns ( Task )

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

BatchCreateTasksRequest

BatchCreateTask অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম। দ্রষ্টব্য: আপনি যদি এই ক্ষেত্রটি সেট করেন, তাহলে CreateTaskRequest বার্তাগুলির শিরোনাম ক্ষেত্রটি হয় খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে।

parent

string

প্রয়োজন। সমস্ত কাজের দ্বারা ভাগ করা মূল সম্পদ। এই মানটি অবশ্যই providers/{provider} ফর্ম্যাটে হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project । CreateTaskRequest বার্তাগুলির মূল ক্ষেত্রটি অবশ্যই খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে৷

requests[]

CreateTaskRequest

প্রয়োজন। অনুরোধ বার্তা যা তৈরি করার জন্য সংস্থানগুলি নির্দিষ্ট করে৷ দ্রষ্টব্য: আপনি একটি ব্যাচে সর্বাধিক 500টি কাজ তৈরি করতে পারেন।

BatchCreateTasksResponse

BatchCreateTask প্রতিক্রিয়া বার্তা।

ক্ষেত্র
tasks[]

Task

তৈরি করা টাস্ক.

ডেলিভারি যানবাহনের অনুরোধ তৈরি করুন

CreateDeliveryVehicle অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

parent

string

প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। প্রদানকারীকে অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

delivery_vehicle_id

string

প্রয়োজন। ডেলিভারি গাড়ির আইডি অবশ্যই অনন্য এবং নিম্নলিখিত বিধিনিষেধ সাপেক্ষে হতে হবে:

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

DeliveryVehicle

প্রয়োজন। DeliveryVehicle সত্তা তৈরি করতে হবে। একটি নতুন ডেলিভারি গাড়ি তৈরি করার সময়, আপনি নিম্নলিখিত ঐচ্ছিক ক্ষেত্রগুলি সেট করতে পারেন:

  • টাইপ
  • শেষ অবস্থান
  • গুণাবলী

দ্রষ্টব্য: Delivery Vehicle এর name ক্ষেত্রটি উপেক্ষা করা হয়েছে। অন্যান্য সমস্ত ডেলিভারি যানবাহন ক্ষেত্র অবশ্যই সেট করা উচিত নয়; অন্যথায়, একটি ত্রুটি ফেরত দেওয়া হয়।

TaskRequest তৈরি করুন

CreateTask অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

parent

string

প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

task_id

string

প্রয়োজন। টাস্ক আইডিটি অবশ্যই অনন্য হতে হবে, তবে এটি একটি শিপমেন্ট ট্র্যাকিং আইডি হওয়া উচিত নয়৷ একটি শিপমেন্ট ট্র্যাকিং আইডি সংরক্ষণ করতে, tracking_id ক্ষেত্রটি ব্যবহার করুন৷ মনে রাখবেন যে একাধিক কাজের একই tracking_id থাকতে পারে। টাস্ক আইডি নিম্নলিখিত বিধিনিষেধ সাপেক্ষে:

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

Task

প্রয়োজন। তৈরি করার টাস্ক সত্তা। একটি টাস্ক তৈরি করার সময়, নিম্নলিখিত ক্ষেত্রগুলি প্রয়োজন:

  • type
  • state ( OPEN সেট করা আবশ্যক)
  • tracking_id ( UNAVAILABLE বা SCHEDULED_STOP কাজের জন্য সেট করা উচিত নয়, তবে অন্যান্য সমস্ত ধরনের কাজের জন্য প্রয়োজন)
  • planned_location ( UNAVAILABLE কাজের জন্য ঐচ্ছিক)
  • task_duration

দ্রষ্টব্য: টাস্কের name ক্ষেত্রটি উপেক্ষা করা হয়েছে। অন্য সব টাস্ক ফিল্ড সেট করা উচিত নয়; অন্যথায়, একটি ত্রুটি ফেরত দেওয়া হয়।

DeliveryRequest Header

একটি রিকোয়েস্টহেডারে সমস্ত ডেলিভারি RPC অনুরোধের জন্য সাধারণ ক্ষেত্র রয়েছে।

ক্ষেত্র
language_code

string

BCP-47 ভাষার কোড, যেমন en-US বা sr-Latn। আরও তথ্যের জন্য, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier দেখুন। কোনোটি নির্দিষ্ট না থাকলে, প্রতিক্রিয়াটি যে কোনো ভাষায় হতে পারে, যদি এমন একটি নাম বিদ্যমান থাকে তবে ইংরেজির জন্য অগ্রাধিকার সহ। ক্ষেত্রের মান উদাহরণ: en-US .

region_code

string

প্রয়োজন। যে অঞ্চলে অনুরোধটি আসে সেই অঞ্চলের CLDR অঞ্চল কোড৷ ক্ষেত্রের মান উদাহরণ: US ।

sdk_version

string

কলিং SDK-এর সংস্করণ, যদি প্রযোজ্য হয়। সংস্করণ বিন্যাস হল "major.minor.patch", উদাহরণ: 1.1.2 ।

os_version

string

যে অপারেটিং সিস্টেমে কলিং SDK চলছে তার সংস্করণ৷ ক্ষেত্রের মান উদাহরণ: 4.4.1 , 12.1 ।

device_model

string

যে ডিভাইসে কলিং SDK চলছে তার মডেল৷ ক্ষেত্রের মান উদাহরণ: iPhone12,1 , SM-G920F ।

sdk_type

SdkType

অনুরোধ পাঠানোর SDK প্রকার।

maps_sdk_version

string

MapSDK-এর যে সংস্করণটি কলিং SDK নির্ভর করে, যদি প্রযোজ্য হয়। সংস্করণ বিন্যাস হল "major.minor.patch", উদাহরণ: 5.2.1 ।

nav_sdk_version

string

NavSDK এর যে সংস্করণটি কলিং SDK নির্ভর করে, যদি প্রযোজ্য হয়। সংস্করণ বিন্যাস হল "major.minor.patch", উদাহরণ: 2.1.0 ।

platform

Platform

কলিং SDK-এর প্ল্যাটফর্ম।

manufacturer

string

কলিং SDK থেকে Android ডিভাইসের নির্মাতা, শুধুমাত্র Android SDK-এর জন্য প্রযোজ্য৷ ক্ষেত্রের মান উদাহরণ: Samsung ।

android_api_level

int32

কলিং SDK-এর Android API স্তর, শুধুমাত্র Android SDK-এর জন্য প্রযোজ্য৷ ক্ষেত্রের মান উদাহরণ: 23 ।

trace_id

string

ঐচ্ছিক আইডি যা অনুরোধ শনাক্ত করার জন্য লগিংয়ের উদ্দেশ্যে প্রদান করা যেতে পারে।

প্ল্যাটফর্ম

কলিং SDK এর প্ল্যাটফর্ম।

Enums
PLATFORM_UNSPECIFIED ডিফল্ট মান। প্ল্যাটফর্মটি বাদ দিলে এই মানটি ব্যবহার করা হয়।
ANDROID অনুরোধটি অ্যান্ড্রয়েড থেকে আসছে।
IOS অনুরোধটি iOS থেকে আসছে।
WEB অনুরোধ ওয়েব থেকে আসছে.

SdkType

সম্ভাব্য ধরনের SDK।

Enums
SDK_TYPE_UNSPECIFIED ডিফল্ট মান। sdk_type বাদ দিলে এই মানটি ব্যবহার করা হয়।
CONSUMER কলিং SDK হল ভোক্তা৷
DRIVER কলিং SDK হল ড্রাইভার৷
JAVASCRIPT কলিং SDK হল জাভাস্ক্রিপ্ট।

ডেলিভারি যানবাহন

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

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

ক্ষেত্র
name

string

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

last_location

DeliveryVehicleLocation

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

navigation_status

DeliveryVehicleNavigationStatus

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

current_route_segment

bytes

এনকোড করা পলিলাইন সেই রুটটি নির্দিষ্ট করে যা নেভিগেশন পরবর্তী ওয়েপয়েন্টে যাওয়ার পরামর্শ দেয়। আপনার ড্রাইভার অ্যাপ এটি আপডেট করে যখন একটি স্টপে পৌঁছানো বা পাস করা হয়, এবং যখন নেভিগেশন পুনরায় রুট হয়। এই 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):

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

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

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

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

current_route_segment_end_point

LatLng

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

current_route_segment ক্ষেত্রটি খালি থাকলে UpdateDeliveryVehicle কলে এই ক্ষেত্রটিকে উপেক্ষা করা হয়।

remaining_distance_meters

Int32Value

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

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

remaining_duration

Duration

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

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

remaining_vehicle_journey_segments[]

VehicleJourneySegment

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

attributes[]

DeliveryVehicleAttribute

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

type

DeliveryVehicleType

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

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

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

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

DeliveryVehicleAttribute

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

ক্ষেত্র
key

string

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

value

string

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

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

string

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

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

bool_value

bool

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

number_value

double

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

ডেলিভারি যানবাহন অবস্থান

একটি সময়ে একটি গাড়ির অবস্থান, গতি এবং শিরোনাম।

ক্ষেত্র
location

LatLng

গাড়ির অবস্থান। যখন এটি ফ্লিট ইঞ্জিনে পাঠানো হয়, তখন গাড়ির অবস্থান একটি GPS অবস্থান। আপনি যখন এটি একটি প্রতিক্রিয়া হিসাবে পান, তখন গাড়ির অবস্থানটি হয় একটি GPS অবস্থান, একটি পরিপূরক অবস্থান, বা অন্য কিছু আনুমানিক অবস্থান হতে পারে৷ উৎসটি location_sensor এ উল্লেখ করা হয়েছে।

horizontal_accuracy
(deprecated)

DoubleValue

বাতিল করা হয়েছে: এর পরিবর্তে latlng_accuracy ব্যবহার করুন।

latlng_accuracy

DoubleValue

ব্যাসার্ধ হিসাবে মিটারে location নির্ভুলতা।

heading

Int32Value

ডিগ্রীতে গাড়ির গতিপথ। 0 উত্তর প্রতিনিধিত্ব করে। বৈধ পরিসীমা হল [0,360)।

bearing_accuracy
(deprecated)

DoubleValue

বাতিল করা হয়েছে: পরিবর্তে heading_accuracy ব্যবহার করুন।

heading_accuracy

DoubleValue

ডিগ্রীতে heading যথার্থতা।

altitude

DoubleValue

WGS84 এর উপরে মিটারে উচ্চতা।

vertical_accuracy
(deprecated)

DoubleValue

অপ্রচলিত: পরিবর্তে altitude_accuracy ব্যবহার করুন।

altitude_accuracy

DoubleValue

মিটারে altitude নির্ভুলতা।

speed_kmph
(deprecated)

Int32Value

ঘণ্টায় কিলোমিটারে গাড়ির গতি। বাতিল করা হয়েছে: পরিবর্তে speed ব্যবহার করুন।

speed

DoubleValue

মিটার/সেকেন্ডে গাড়ির গতি

speed_accuracy

DoubleValue

মিটার/সেকেন্ডে speed নির্ভুলতা।

update_time

Timestamp

সেন্সরের ঘড়ি অনুসারে সেন্সর দ্বারা location জানানোর সময়।

server_time

Timestamp

শুধুমাত্র আউটপুট। যে সময় সার্ভার অবস্থানের তথ্য পেয়েছে।

location_sensor

DeliveryVehicleLocationSensor

অবস্থান ডেটা প্রদানকারী (উদাহরণস্বরূপ, GPS )।

is_road_snapped

BoolValue

location একটি রাস্তায় স্ন্যাপ করা হয়েছে কিনা।

is_gps_sensor_enabled

BoolValue

শুধুমাত্র ইনপুট। মোবাইল ডিভাইসে GPS সেন্সর সক্ষম কিনা তা নির্দেশ করে৷

time_since_update

Int32Value

শুধুমাত্র ইনপুট। এই অবস্থানটি প্রথম সার্ভারে পাঠানোর সময় (সেকেন্ডে)৷ এটি প্রথম আপডেটের জন্য শূন্য হবে। যদি সময়টি অজানা থাকে (উদাহরণস্বরূপ, যখন অ্যাপটি পুনরায় চালু হয়), এই মানটি শূন্যে পুনরায় সেট হয়৷

num_stale_updates
(deprecated)

Int32Value

শুধুমাত্র ইনপুট। অপ্রচলিত: একটি অবস্থান পুরানো কিনা তা নির্ধারণ করতে এখন অন্যান্য সংকেত ব্যবহার করা হয়।

raw_location

LatLng

কাঁচা গাড়ির অবস্থান (রোড-স্ন্যাপার দ্বারা প্রক্রিয়াজাত করা হয়নি)।

raw_location_time

Timestamp

কাঁচা অবস্থানের সাথে যুক্ত টাইমস্ট্যাম্প।

raw_location_sensor

DeliveryVehicleLocationSensor

কাঁচা অবস্থানের উৎস। GPS ডিফল্ট।

raw_location_accuracy

DoubleValue

একটি ব্যাসার্ধ হিসাবে raw_location এর যথার্থতা, মিটারে।

supplemental_location

LatLng

সমন্বিত অ্যাপ দ্বারা সরবরাহিত পরিপূরক অবস্থান।

supplemental_location_time

Timestamp

পরিপূরক অবস্থানের সাথে যুক্ত টাইমস্ট্যাম্প।

supplemental_location_sensor

DeliveryVehicleLocationSensor

সম্পূরক অবস্থানের উৎস। CUSTOMER_SUPPLIED_LOCATION এ ডিফল্ট।

supplemental_location_accuracy

DoubleValue

supplemental_location যথার্থতা ব্যাসার্ধ হিসাবে, মিটারে।

road_snapped
(deprecated)

bool

অপ্রচলিত: পরিবর্তে is_road_snapped ব্যবহার করুন।

ডেলিভারি যানবাহন অবস্থান সেন্সর

অবস্থান নির্ধারণ করতে ব্যবহৃত সেন্সর বা পদ্ধতি।

Enums
UNKNOWN_SENSOR সেন্সর অনির্দিষ্ট বা অজানা।
GPS জিপিএস বা অ্যাসিস্টেড জিপিএস।
NETWORK সহায়ক জিপিএস, সেল টাওয়ার আইডি, বা ওয়াইফাই অ্যাক্সেস পয়েন্ট।
PASSIVE সেল টাওয়ার আইডি বা ওয়াইফাই অ্যাক্সেস পয়েন্ট।
ROAD_SNAPPED_LOCATION_PROVIDER মোবাইল ডিভাইস দ্বারা নির্ধারিত একটি অবস্থান যা রাস্তার সম্ভাব্য অবস্থান।
CUSTOMER_SUPPLIED_LOCATION একটি স্বাধীন উৎস থেকে গ্রাহকের সরবরাহকৃত অবস্থান। সাধারণত, এই মানটি ড্রাইভার SDK চালিত মোবাইল ডিভাইস ব্যতীত অন্য উত্স থেকে সরবরাহ করা অবস্থানের জন্য ব্যবহার করা হয়৷ যদি মূল উৎস অন্য enum মানগুলির একটি দ্বারা বর্ণিত হয়, তাহলে সেই মানটি ব্যবহার করুন। CUSTOMER_SUPPLIED_LOCATION চিহ্নিত অবস্থানগুলি সাধারণত একটি DeliveryVehicle এর last_location.supplemental_location_sensor এর মাধ্যমে প্রদান করা হয়।
FLEET_ENGINE_LOCATION এটিতে উপলব্ধ সিগন্যালের উপর ভিত্তি করে ফ্লিট ইঞ্জিন দ্বারা গণনা করা একটি অবস্থান। শুধুমাত্র আউটপুট। এই মানটি প্রত্যাখ্যান করা হবে যদি এটি একটি অনুরোধে প্রাপ্ত হয়।
FUSED_LOCATION_PROVIDER অ্যান্ড্রয়েডের ফিউজড লোকেশন প্রোভাইডার।
CORE_LOCATION Apple অপারেটিং সিস্টেমে অবস্থান প্রদানকারী।

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

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

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

DeliveryVehicleRequest পান

GetDeliveryVehicle অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

name

string

প্রয়োজন। providers/{provider}/deliveryVehicles/{delivery_vehicle} ফর্ম্যাটে হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

GetTaskRequest

GetTask অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

name

string

প্রয়োজন। ফর্ম্যাট providers/{provider}/tasks/{task} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

GetTaskTrackingInfoRequest

GetTaskTrackingInfoRequest অনুরোধ বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

name

string

প্রয়োজন। ফর্ম্যাট providers/{provider}/taskTrackingInfo/{tracking_id} হতে হবে। provider অবশ্যই Google ক্লাউড প্রজেক্ট আইডি হতে হবে এবং tracking_id অবশ্যই টাস্কের সাথে যুক্ত ট্র্যাকিং আইডি হতে হবে। একটি উদাহরণের নাম providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id হতে পারে।

তালিকা ডেলিভারি যানবাহন অনুরোধ

ListDeliveryVehicles অনুরোধ বার্তা.

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

parent

string

প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

page_size

int32

ঐচ্ছিক। ফেরার জন্য সর্বাধিক সংখ্যক যানবাহন। পরিষেবাটি এই সংখ্যার চেয়ে কম ফেরত দিতে পারে। আপনি যদি এই নম্বরটি নির্দিষ্ট না করেন, তাহলে সার্ভার ফলাফলের সংখ্যা নির্ধারণ করে।

page_token

string

ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী ListDeliveryVehicles কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য আপনাকে অবশ্যই এটি প্রদান করতে হবে।

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

filter

string

ঐচ্ছিক। ডেলিভারি গাড়ির তালিকা করার সময় আবেদন করার জন্য একটি ফিল্টার ক্যোয়ারী। ফিল্টার সিনট্যাক্সের উদাহরণের জন্য http://aip.dev/160 দেখুন। আপনি যদি একটি মান নির্দিষ্ট না করেন, বা যদি আপনি ফিল্টারের জন্য একটি খালি স্ট্রিং নির্দিষ্ট করেন, তাহলে সমস্ত ডেলিভারি যান ফেরত দেওয়া হয়৷

মনে রাখবেন যে শুধুমাত্র ListDeliveryVehicles এর জন্য সমর্থিত প্রশ্নগুলি যানবাহনের বৈশিষ্ট্যগুলিতে (উদাহরণস্বরূপ, attributes.<key> = <value> বা attributes.<key1> = <value1> AND attributes.<key2> = <value2> )। এছাড়াও, সমস্ত বৈশিষ্ট্য স্ট্রিং হিসাবে সংরক্ষণ করা হয়, তাই বৈশিষ্ট্যগুলির সাথে শুধুমাত্র সমর্থিত তুলনাগুলি হল স্ট্রিং তুলনা। সংখ্যা বা বুলিয়ান মানের সাথে তুলনা করার জন্য, স্ট্রিং হিসাবে বিবেচনা করার জন্য মানগুলিকে স্পষ্টভাবে উদ্ধৃত করতে হবে (উদাহরণস্বরূপ, attributes.<key> = "10" বা attributes.<key> = "true" )।

একটি ফিল্টার ক্যোয়ারীতে অনুমোদিত সীমাবদ্ধতার সর্বাধিক সংখ্যা 50৷ একটি সীমাবদ্ধতা হল ফর্ম attribute.<KEY> <COMPARATOR> <VALUE> , উদাহরণস্বরূপ attributes.foo = bar হল 1টি সীমাবদ্ধতা৷

viewport

Viewport

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

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

ListDeliveryVehicles প্রতিক্রিয়া বার্তা।

ক্ষেত্র
delivery_vehicles[]

DeliveryVehicle

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

next_page_token

string

আপনি ফলাফল তালিকা চালিয়ে যেতে ListDeliveryVehiclesRequest এ এই টোকেনটি পাস করতে পারেন। যখন সমস্ত ফলাফল ফিরে আসে, তখন এই ক্ষেত্রটি প্রতিক্রিয়াতে থাকবে না, বা এটি একটি খালি স্ট্রিং হবে।

total_size

int64

সমস্ত পৃষ্ঠা জুড়ে অনুরোধের মানদণ্ডের সাথে মেলে এমন ডেলিভারি গাড়ির মোট সংখ্যা৷

তালিকা টাস্ক রিকোয়েস্ট

ListTasks অনুরোধ বার্তা.

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

parent

string

প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

page_size

int32

ঐচ্ছিক। ফেরত দেওয়ার জন্য সর্বাধিক সংখ্যক টাস্ক। পরিষেবাটি এই মানের থেকে কম ফেরত দিতে পারে। আপনি যদি এই মানটি নির্দিষ্ট না করেন, তাহলে সার্ভার ফলাফলের সংখ্যা নির্ধারণ করে যা ফেরত দিতে হবে।

page_token

string

ঐচ্ছিক। পূর্ববর্তী ListTasks কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। আপনি পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করতে পারেন।

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

filter

string

ঐচ্ছিক। কার্য তালিকাভুক্ত করার সময় প্রয়োগ করার জন্য একটি ফিল্টার ক্যোয়ারী। ফিল্টার সিনট্যাক্সের উদাহরণের জন্য http://aip.dev/160 দেখুন। আপনি যদি একটি মান নির্দিষ্ট না করেন, অথবা যদি আপনি একটি খালি স্ট্রিং এ ফিল্টার করেন, তাহলে সমস্ত কার্য ফেরত দেওয়া হয়। আপনি যে টাস্ক বৈশিষ্ট্যগুলি ফিল্টার করতে পারেন সে সম্পর্কে তথ্যের জন্য, কার্য তালিকা দেখুন।

ListTasksResponse

ListTasks প্রতিক্রিয়া যা ListTasksRequest এর ফিল্টারের মানদণ্ড পূরণ করে এমন টাস্কগুলির সেট ধারণ করে।

ক্ষেত্র
tasks[]

Task

টাস্কের সেট যা অনুরোধ করা ফিল্টারিং মানদণ্ড পূরণ করে। যখন কোন ফিল্টার নির্দিষ্ট করা হয় না, অনুরোধটি সমস্ত কাজ ফেরত দেয়। একটি সফল প্রতিক্রিয়াও খালি হতে পারে। একটি খালি প্রতিক্রিয়া নির্দেশ করে যে অনুরোধ করা ফিল্টার মানদণ্ড পূরণ করে কোনো কাজ পাওয়া যায়নি।

next_page_token

string

ফলাফল তালিকা চালিয়ে যেতে ListTasksRequest এ এই টোকেনটি পাস করুন। যদি সমস্ত ফলাফল ফেরত দেওয়া হয়, তাহলে এই ক্ষেত্রটি হয় একটি খালি স্ট্রিং, অথবা এটি প্রতিক্রিয়াতে প্রদর্শিত হয় না।

total_size

int64

সমস্ত পৃষ্ঠা জুড়ে অনুরোধের মানদণ্ডের সাথে মেলে এমন টাস্কের মোট সংখ্যা৷

অবস্থান তথ্য

যেকোনো অতিরিক্ত শনাক্তকারী সহ একটি অবস্থান।

ক্ষেত্র
point

LatLng

অবস্থান এর স্থানাঙ্ক.

টাস্ক

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

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

ক্ষেত্র
name

string

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

type

Type

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

state

State

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

task_outcome

TaskOutcome

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

task_outcome_time

Timestamp

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

task_outcome_location

LocationInfo

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

task_outcome_location_source

TaskOutcomeLocationSource

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

tracking_id

string

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

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

string

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

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

LocationInfo

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

task_duration

Duration

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

target_time_window

TimeWindow

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

journey_sharing_info

JourneySharingInfo

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

task_tracking_view_config

TaskTrackingViewConfig

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

attributes[]

TaskAttribute

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

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

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

ক্ষেত্র
remaining_vehicle_journey_segments[]

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 মধ্যে রুট তথ্য প্রদান করে।

last_location

DeliveryVehicleLocation

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

last_location_snappable

bool

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

অবস্থা

একটি টাস্কের অবস্থা। এটি টাস্কের অগ্রগতি নির্দেশ করে।

Enums
STATE_UNSPECIFIED ডিফল্ট। একটি অনির্দিষ্ট বা অস্বীকৃত টাস্ক অবস্থার জন্য ব্যবহৃত হয়।
OPEN হয় টাস্কটি এখনও কোনও ডেলিভারি গাড়ির জন্য বরাদ্দ করা হয়নি, বা ডেলিভারি গাড়িটি এখনও Task নির্ধারিত গাড়ির স্টপ অতিক্রম করেনি৷
CLOSED যখন যানবাহনটি চলে যায় তখন এই টাস্কের জন্য গাড়ি থামান।

টাস্কআউটকাম

একটি টাস্ক চালানোর প্রচেষ্টার ফলাফল। TaskState বন্ধ হলে, TaskOutcome নির্দেশ করে যে এটি সফলভাবে সম্পন্ন হয়েছে কিনা।

Enums
TASK_OUTCOME_UNSPECIFIED এর মান সেট করার আগে টাস্ক ফলাফল।
SUCCEEDED টাস্ক সফলভাবে সম্পন্ন হয়েছে.
FAILED হয় টাস্কটি সম্পূর্ণ করা যায়নি, বা এটি বাতিল করা হয়েছে।

TaskOutcomeLocationSource

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

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

টাইপ

টাস্কের ধরন।

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

টাস্ক অ্যাট্রিবিউট

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

ক্ষেত্র
key

string

বৈশিষ্ট্য এর কী. কীগুলিতে কোলন অক্ষর (:) থাকতে পারে না।

ইউনিয়ন ফিল্ড task_attribute_value । অ্যাট্রিবিউটের মান, স্ট্রিং, বুল বা ডাবল টাইপের হতে পারে। যদি কোনোটিই সেট করা না থাকে তাহলে TaskAttribute string_value খালি স্ট্রিং "" হিসাবে সংরক্ষণ করা হবে। task_attribute_value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
string_value

string

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

bool_value

bool

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

number_value

double

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

টাস্কট্র্যাকিং তথ্য

TaskTrackingInfo বার্তা। বার্তাটিতে টাস্ক ট্র্যাকিং তথ্য রয়েছে যা প্রদর্শনের জন্য ব্যবহার করা হবে। যদি একটি ট্র্যাকিং আইডি একাধিক টাস্কের সাথে যুক্ত থাকে, তাহলে কোন টাস্কের টাস্কট্র্যাকিং ইনফো নির্বাচন করতে হবে তা নির্ধারণ করতে ফ্লিট ইঞ্জিন একটি হিউরিস্টিক ব্যবহার করে।

ক্ষেত্র
name

string

ফর্ম্যাট providers/{provider}/taskTrackingInfo/{tracking} হতে হবে, যেখানে tracking ট্র্যাকিং আইডিকে প্রতিনিধিত্ব করে৷

tracking_id

string

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

vehicle_location

DeliveryVehicleLocation

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

route_polyline_points[]

LatLng

পয়েন্টগুলির একটি তালিকা যা সংযুক্ত হলে এই টাস্কের অবস্থানে গাড়ির প্রত্যাশিত রুটের একটি পলিলাইন তৈরি করে।

remaining_stop_count

Int32Value

টাস্ক স্টপ সহ টাস্ক স্টপে না পৌঁছানো পর্যন্ত গাড়ির কত স্টপ আছে তা নির্দেশ করে। উদাহরণস্বরূপ, যদি গাড়ির পরবর্তী স্টপ টাস্ক স্টপ হয়, তাহলে মান হবে 1।

remaining_driving_distance_meters

Int32Value

আগ্রহের VehicleStop স্টপে মিটারে মোট বাকি দূরত্ব।

estimated_arrival_time

Timestamp

টাইমস্ট্যাম্প যা স্টপ অবস্থানে আনুমানিক আগমনের সময় নির্দেশ করে।

estimated_task_completion_time

Timestamp

টাইমস্ট্যাম্প যা একটি টাস্কের আনুমানিক সমাপ্তির সময় নির্দেশ করে।

state

State

টাস্কের বর্তমান নির্বাহের অবস্থা।

task_outcome

TaskOutcome

একটি টাস্ক চালানোর প্রচেষ্টার ফলাফল।

task_outcome_time

Timestamp

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

planned_location

LocationInfo

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

target_time_window

TimeWindow

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

attributes[]

TaskAttribute

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

TaskTrackingViewConfig

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

ক্ষেত্র
route_polyline_points_visibility

VisibilityOption

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

estimated_arrival_time_visibility

VisibilityOption

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

estimated_task_completion_time_visibility

VisibilityOption

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

remaining_driving_distance_visibility

VisibilityOption

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

remaining_stop_count_visibility

VisibilityOption

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

vehicle_location_visibility

VisibilityOption

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

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

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

ক্ষেত্র
ইউনিয়ন ক্ষেত্রের visibility_option । নির্দিষ্ট দৃশ্যমানতার বিকল্পটি বেছে নেওয়া হয়েছে। visibility_option নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
remaining_stop_count_threshold

int32

অবশিষ্ট স্টপ গণনা <= বাকি_স্টপ_কাউন্ট_থ্রেশহোল্ড থাকলে এই ডেটা উপাদানটি শেষ ব্যবহারকারীদের কাছে দৃশ্যমান।

duration_until_estimated_arrival_time_threshold

Duration

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

remaining_driving_distance_meters_threshold

int32

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

always

bool

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

never

bool

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

টাইম উইন্ডো

একটি সময় পরিসীমা।

ক্ষেত্র
start_time

Timestamp

প্রয়োজন। টাইম উইন্ডোর শুরুর সময় (অন্তর্ভুক্ত)।

end_time

Timestamp

প্রয়োজন। টাইম উইন্ডোর শেষ সময় (অন্তর্ভুক্ত)।

UpdateDeliveryVehicleRequest

UpdateDeliveryVehicle অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

delivery_vehicle

DeliveryVehicle

প্রয়োজন। DeliveryVehicle সত্তার আপডেট আবেদন করতে হবে। দ্রষ্টব্য: আপনি DeliveryVehicle এর নাম আপডেট করতে পারবেন না।

update_mask

FieldMask

প্রয়োজন। একটি ফিল্ড মাস্ক যা নির্দেশ করে যে কোন DeliveryVehicle ফিল্ড আপডেট করতে হবে। মনে রাখবেন আপডেট_মাস্কে কমপক্ষে একটি ক্ষেত্র থাকতে হবে।

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "remaining_vehicle_journey_segments" ।

UpdateTaskRequest

UpdateTask অনুরোধের বার্তা।

ক্ষেত্র
header

DeliveryRequestHeader

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

task

Task

প্রয়োজন। আপডেটের সাথে যুক্ত টাস্ক। নিম্নলিখিত ক্ষেত্রগুলি ফ্লিট ইঞ্জিন দ্বারা রক্ষণাবেক্ষণ করা হয়। Task.update ব্যবহার করে তাদের আপডেট করবেন না।

  • last_location ।
  • last_location_snappable ।
  • name
  • remaining_vehicle_journey_segments ।
  • task_outcome_location_source

দ্রষ্টব্য: আপনি একবার সেট করার পরে task_outcome মান পরিবর্তন করতে পারবেন না।

যদি টাস্কটি ডেলিভারি গাড়ির জন্য বরাদ্দ করা হয়ে থাকে, তাহলে Task.update ব্যবহার করে টাস্ক স্টেট বন্ধ করে দেবেন না। পরিবর্তে, ডেলিভারি গাড়ি থেকে টাস্ক রয়েছে এমন VehicleStop সরান, যা স্বয়ংক্রিয়ভাবে টাস্ক স্টেটকে বন্ধ করে দেয়।

update_mask

FieldMask

প্রয়োজন। ফিল্ড মাস্ক যা নির্দেশ করে কোন টাস্ক ফিল্ড আপডেট করতে হবে। দ্রষ্টব্য: update_mask কমপক্ষে একটি ক্ষেত্র থাকতে হবে।

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "task_outcome,task_outcome_time,task_outcome_location" ।

যানবাহন জার্নি সেগমেন্ট

একটি যানবাহনের ভ্রমণ বিভাগের প্রতিনিধিত্ব করে - এর আগের স্টপ থেকে বর্তমান স্টপ পর্যন্ত। যদি এটি প্রথম সক্রিয় স্টপ হয়, তাহলে এটি গাড়ির বর্তমান অবস্থান থেকে এই স্টপেজ পর্যন্ত।

ক্ষেত্র
stop

VehicleStop

স্টপের সাথে যুক্ত Task সাথে স্টপ অবস্থান নির্দিষ্ট করে। এই যাত্রা অংশটি JourneySharingInfo এর অংশ হলে VehicleStop-এর কিছু ক্ষেত্র উপস্থিত নাও থাকতে পারে।

driving_distance_meters

Int32Value

শুধুমাত্র আউটপুট। পূর্ববর্তী স্টপ থেকে এই স্টপে ভ্রমণের দূরত্ব। যদি বর্তমান স্টপটি জার্নি বিভাগগুলির তালিকার প্রথম স্টপ হয়, তবে প্রারম্ভিক পয়েন্টটি হ'ল গাড়ির অবস্থানটি রেকর্ড করা হয়েছে যে এই স্টপটি তালিকায় যুক্ত করা হয়েছিল। যদি এই যাত্রা বিভাগটি JourneySharingInfo অংশ হয় তবে এই ক্ষেত্রটি উপস্থিত নাও থাকতে পারে।

driving_duration

Duration

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

যদি এই ক্ষেত্রটি পাথ Task.remaining_vehicle_journey_segments[0].driving_duration সংজ্ঞায়িত DeliveryVehicle.remainingDuration DeliveryVehicle.remaining_duration Task.remainingVehicleJourneySegments[0].drivingDuration DeliveryVehicle.remainingDuration (বিশ্রাম)। এটি পূর্ববর্তী স্টপ থেকে ড্রাইভিং সময়ের চেয়ে ড্রাইভার অ্যাপের সর্বশেষ পরিচিত অবস্থান থেকে অবশিষ্ট ড্রাইভিং সময়কাল সরবরাহ করে।

path[]

LatLng

শুধুমাত্র আউটপুট। পূর্ববর্তী স্টপ থেকে এই স্টপ পর্যন্ত পথ। যদি বর্তমান স্টপটি জার্নি বিভাগগুলির তালিকার প্রথম স্টপ হয়, তবে এই স্টপটি তালিকায় যুক্ত করার সময় গাড়ির বর্তমান অবস্থান থেকে এই স্টপ পর্যন্ত এই পথ। যদি এই যাত্রা বিভাগটি JourneySharingInfo অংশ হয় তবে এই ক্ষেত্রটি উপস্থিত নাও থাকতে পারে।

যদি এই ক্ষেত্রটি পাথ Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path সংজ্ঞায়িত LatLng DeliveryVehicle.current_route_segment Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (জিআরপিসি) বা DeliveryVehicle.currentRouteSegment (আরইএসটি)। এটি পূর্ববর্তী স্টপ থেকে পথের চেয়ে ড্রাইভার অ্যাপের সর্বশেষ পরিচিত অবস্থান থেকে ড্রাইভিং পাথ সরবরাহ করে।

যানবাহন

এমন একটি বিন্দু বর্ণনা করে যেখানে কোনও যানবাহন এক বা একাধিক Task সম্পাদন করতে থামে।

ক্ষেত্র
planned_location

LocationInfo

প্রয়োজন। স্টপের অবস্থান। নোট করুন যে Task এস এর অবস্থানগুলি ঠিক এই অবস্থানের সাথে মেলে না, তবে এটির অল্প দূরত্বের মধ্যে থাকবে। GetTask কলের প্রতিক্রিয়াতে এই ক্ষেত্রটি পপুলেশন করা হবে না।

tasks[]

TaskInfo

এই স্টপে সঞ্চালিত Task এস এর তালিকা। GetTask কলের প্রতিক্রিয়াতে এই ক্ষেত্রটি পপুলেশন করা হবে না।

state

State

VehicleStop অবস্থা। GetTask কলের প্রতিক্রিয়াতে এই ক্ষেত্রটি পপুলেশন করা হবে না।

অবস্থা

একটি VehicleStop বর্তমান অবস্থা।

Enums
STATE_UNSPECIFIED অজানা।
NEW তৈরি, তবে সক্রিয়ভাবে রাউটিং নয়।
ENROUTE নির্ধারিত এবং সক্রিয়ভাবে রাউটিং।
ARRIVED স্টপ এ পৌঁছেছে। ধরে নিয়েছে যে গাড়িটি যখন পরবর্তী স্টপে যাওয়ার সময়, পূর্ববর্তী সমস্ত স্টপগুলি সম্পন্ন হয়েছে।

টাস্ক ইনফো

এই স্টপে সম্পাদিত টাস্ক সম্পর্কে অতিরিক্ত তথ্য।

ক্ষেত্র
task_id

string

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

task_duration

Duration

শুধুমাত্র আউটপুট। কাজটি সম্পাদন করার জন্য প্রয়োজনীয় সময়।

target_time_window

TimeWindow

শুধুমাত্র আউটপুট। সময় উইন্ডো যার সময় কাজটি সম্পন্ন করা উচিত। এটি কেবল GetDeliveryVehicle প্রতিক্রিয়াতে সেট করা আছে।