REST Resource: selection.v1.projects.selectedRoutes

রিসোর্স: নির্বাচিত রুট

একটি নির্বাচিত রুট (SelectedRoute) এমন একটি নির্দিষ্ট পথকে বোঝায়, যেটির তথ্য (যেমন সময়কাল) একজন গ্রাহক চুক্তিবদ্ধ ব্যবহারের জন্য পর্যায়ক্রমে সংগ্রহ করতে চান।

JSON উপস্থাপনা 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "state": enum (State),
  "routeAttributes": {
    string: string,
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a request:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of mutually exclusive fields.
  "validationError": enum (ValidationError)
}
ক্ষেত্র
name

string

শনাক্তকারী। SelectedRoute রিসোর্স নাম।

ফর্ম্যাট: projects/{project}/selectedRoutes/{selectedRoute}

displayName

string

ঐচ্ছিক। রুটের প্রদর্শিত নাম। এটি একটি ঐচ্ছিক ফিল্ড যা গ্রাহক ব্যবহার করতে পারেন। এটি অনন্য হতে হবে এমন কোনো বাধ্যবাধকতা নেই। এর দৈর্ঘ্য ১০০ অক্ষরের মধ্যে সীমাবদ্ধ (ইউনিকোড কোড পয়েন্টে গণনা করা হয়)।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। নির্বাচিত রুটটি প্রথম তৈরি হওয়ার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

state

enum ( State )

শুধুমাত্র আউটপুট। নির্বাচিত রুটের অবস্থা।

routeAttributes

map (key: string, value: string)

ঐচ্ছিক। নির্বাচিত রুটের জন্য কাস্টম অ্যাট্রিবিউটসমূহ। ঐতিহাসিক এবং রিয়েল-টাইম রুটের তথ্য পুনরুদ্ধার করার সময় এগুলি যোগ করলে রুটগুলি ফিল্টার বা গ্রুপ করা যায়। প্রতি রুটে ২৫টি পর্যন্ত অ্যাট্রিবিউট সমর্থিত। প্রতিটি কী এবং ভ্যালু অবশ্যই একটি নন-এম্পটি স্ট্রিং হতে হবে এবং এতে ১০০টি পর্যন্ত অক্ষর থাকতে পারে (ইউনিকোড কোড পয়েন্টে গণনা করা)। কীগুলি অবশ্যই goog দিয়ে শুরু হবে না।

একটি অবজেক্ট যা "key": value জোড়ের একটি তালিকা ধারণ করে। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" } ।

বর্তমানে শুধুমাত্র DynamicRoute সমর্থিত। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি অনুরোধে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
dynamicRoute

object ( DynamicRoute )

SelectedRoute হলো একটি ডাইনামিক রুট।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।
validationError

enum ( ValidationError )

শুধুমাত্র আউটপুট। স্টেট STATE_INVALID হলে নির্বাচিত রুটের জন্য ভ্যালিডেশন ত্রুটি।

ডাইনামিক রুট

এটি ওয়েপয়েন্ট (উৎস, গন্তব্য এবং মধ্যবর্তী স্থান) সহ একটি পথ নির্দেশ করে। প্রকৃত পথটি যে সমস্ত ওয়েপয়েন্ট অতিক্রম করবেই, তা নিশ্চিত, কিন্তু যানজটের বিভিন্ন অবস্থার কারণে এটি সময়ে সময়ে পরিবর্তিত হতে পারে।

JSON উপস্থাপনা 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
ক্ষেত্র
origin

object ( LatLng )

প্রয়োজনীয়। রুটের উৎস স্থান।

destination

object ( LatLng )

আবশ্যক। রুটের শেষ গন্তব্য।

intermediates[]

object ( LatLng )

ঐচ্ছিক। রুট বরাবর একগুচ্ছ মধ্যবর্তী ওয়েপয়েন্ট (টার্মিনাল পয়েন্ট বাদে)। এগুলো সর্বদা অতিক্রম করার পয়েন্ট। সর্বোচ্চ ২৫টি মধ্যবর্তী ওয়েপয়েন্ট সমর্থন করা হয়। এগুলো সঠিকভাবে যোগ করলে সময়ে সময়ে প্রকৃত রুটের পরিবর্তন কমানো যেতে পারে।

অক্ষাংশ দ্রাঘিমাংশ

একটি অবজেক্ট যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়াকে উপস্থাপন করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ বোঝাতে একজোড়া ডাবল (double) হিসেবে প্রকাশ করা হয়। অন্যভাবে নির্দিষ্ট করা না থাকলে, এই অবজেক্টটিকে অবশ্যই WGS84 স্ট্যান্ডার্ড মেনে চলতে হবে। মানগুলো অবশ্যই নর্মালাইজড রেঞ্জের মধ্যে থাকতে হবে।

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

দ্রাঘিমাংশ ডিগ্রিতে। এটি অবশ্যই [-180.0, +180.0] সীমার মধ্যে হতে হবে।

রাজ্য

নির্বাচিত রুটের অবস্থা।

এনাম
STATE_UNSPECIFIED এই রুটের অবস্থা সেট করা নেই।
STATE_SCHEDULING রুটটি তৈরি করা হয়েছে এবং এর সময়সূচী নির্ধারণ করা হচ্ছে।
STATE_RUNNING রুটটি তৈরি করা হয়েছে এবং এর একটি সক্রিয় সময়সূচী রয়েছে।
STATE_DELETING রুটটি মুছে ফেলার জন্য চিহ্নিত করা হয়েছে।
STATE_VALIDATING রুটটি যাচাই করা হচ্ছে।
STATE_INVALID যাচাইকরণের একটি মানদণ্ডের ভিত্তিতে রুটটি অবৈধ।

বৈধতা ত্রুটি

নির্বাচিত রুটের জন্য যাচাইকরণ ত্রুটি।

এনাম
VALIDATION_ERROR_UNSPECIFIED এই রুটের ভ্যালিডেশন ত্রুটি সেট করা নেই।
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION পথটি প্রকল্পের আওতার বাইরে।
VALIDATION_ERROR_LOW_ROAD_USAGE এই পথটিতে সড়কের ব্যবহার কম (এখান দিয়ে খুব কম লোক যাতায়াত করে)।

পদ্ধতি

batchCreate

 একাধিক SelectedRoute রিসোর্স তৈরি করে এবং প্রতিটি রুটের জন্য পর্যায়ক্রমে ক্যাশ তথ্য পুনরুদ্ধার করার একটি সময়সূচী শুরু করে।

batchDelete

 নির্দিষ্ট প্রজেক্টের অন্তর্গত একাধিক SelectedRoute রিসোর্স মুছে ফেলে।

batchUpdate

 নাম অনুযায়ী একাধিক SelectedRoute রিসোর্স আপডেট করে।

create

 একটি SelectedRoute তৈরি করে এবং সেই রুটের জন্য পর্যায়ক্রমে ক্যাশে তথ্য পুনরুদ্ধার করার একটি সময়সূচী শুরু করে।

delete

 নির্দিষ্ট প্রজেক্টের জন্য নির্দিষ্ট SelectedRoute-টি মুছে দেয়।

get

 নাম অনুযায়ী একটি নির্বাচিত রুট পাওয়া যায়।

list

 নির্দিষ্ট প্রজেক্টের অন্তর্গত সমস্ত SelectedRoute রিসোর্স পেজিনেশন সহ তালিকাভুক্ত করে।

patch

 নাম অনুযায়ী একটি নির্বাচিত রুট আপডেট করে।
,

রিসোর্স: নির্বাচিত রুট

একটি নির্বাচিত রুট (SelectedRoute) এমন একটি নির্দিষ্ট পথকে বোঝায়, যেটির তথ্য (যেমন সময়কাল) একজন গ্রাহক চুক্তিবদ্ধ ব্যবহারের জন্য পর্যায়ক্রমে সংগ্রহ করতে চান।

JSON উপস্থাপনা 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "state": enum (State),
  "routeAttributes": {
    string: string,
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a request:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of mutually exclusive fields.
  "validationError": enum (ValidationError)
}
ক্ষেত্র
name

string

শনাক্তকারী। SelectedRoute রিসোর্স নাম।

ফর্ম্যাট: projects/{project}/selectedRoutes/{selectedRoute}

displayName

string

ঐচ্ছিক। রুটের প্রদর্শিত নাম। এটি একটি ঐচ্ছিক ফিল্ড যা গ্রাহক ব্যবহার করতে পারেন। এটি অনন্য হতে হবে এমন কোনো বাধ্যবাধকতা নেই। এর দৈর্ঘ্য ১০০ অক্ষরের মধ্যে সীমাবদ্ধ (ইউনিকোড কোড পয়েন্টে গণনা করা হয়)।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। নির্বাচিত রুটটি প্রথম তৈরি হওয়ার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

state

enum ( State )

শুধুমাত্র আউটপুট। নির্বাচিত রুটের অবস্থা।

routeAttributes

map (key: string, value: string)

ঐচ্ছিক। নির্বাচিত রুটের জন্য কাস্টম অ্যাট্রিবিউটসমূহ। ঐতিহাসিক এবং রিয়েল-টাইম রুটের তথ্য পুনরুদ্ধার করার সময় এগুলি যোগ করলে রুটগুলি ফিল্টার বা গ্রুপ করা যায়। প্রতি রুটে ২৫টি পর্যন্ত অ্যাট্রিবিউট সমর্থিত। প্রতিটি কী এবং ভ্যালু অবশ্যই একটি নন-এম্পটি স্ট্রিং হতে হবে এবং এতে ১০০টি পর্যন্ত অক্ষর থাকতে পারে (ইউনিকোড কোড পয়েন্টে গণনা করা)। কীগুলি অবশ্যই goog দিয়ে শুরু হবে না।

একটি অবজেক্ট যা "key": value জোড়ের একটি তালিকা ধারণ করে। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" } ।

বর্তমানে শুধুমাত্র DynamicRoute সমর্থিত। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি অনুরোধে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
dynamicRoute

object ( DynamicRoute )

SelectedRoute হলো একটি ডাইনামিক রুট।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।
validationError

enum ( ValidationError )

শুধুমাত্র আউটপুট। স্টেট STATE_INVALID হলে নির্বাচিত রুটের জন্য ভ্যালিডেশন ত্রুটি।

ডাইনামিক রুট

এটি ওয়েপয়েন্ট (উৎস, গন্তব্য এবং মধ্যবর্তী স্থান) সহ একটি পথ নির্দেশ করে। প্রকৃত পথটি যে সমস্ত ওয়েপয়েন্ট অতিক্রম করবেই, তা নিশ্চিত, কিন্তু যানজটের বিভিন্ন অবস্থার কারণে এটি সময়ে সময়ে পরিবর্তিত হতে পারে।

JSON উপস্থাপনা 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
ক্ষেত্র
origin

object ( LatLng )

প্রয়োজনীয়। রুটের উৎস স্থান।

destination

object ( LatLng )

আবশ্যক। রুটের শেষ গন্তব্য।

intermediates[]

object ( LatLng )

ঐচ্ছিক। রুট বরাবর একগুচ্ছ মধ্যবর্তী ওয়েপয়েন্ট (টার্মিনাল পয়েন্ট বাদে)। এগুলো সর্বদা অতিক্রম করার পয়েন্ট। সর্বোচ্চ ২৫টি মধ্যবর্তী ওয়েপয়েন্ট সমর্থন করা হয়। এগুলো সঠিকভাবে যোগ করলে সময়ে সময়ে প্রকৃত রুটের পরিবর্তন কমানো যেতে পারে।

অক্ষাংশ দ্রাঘিমাংশ

একটি অবজেক্ট যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়াকে উপস্থাপন করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ বোঝাতে একজোড়া ডাবল (double) হিসেবে প্রকাশ করা হয়। অন্যভাবে নির্দিষ্ট করা না থাকলে, এই অবজেক্টটিকে অবশ্যই WGS84 স্ট্যান্ডার্ড মেনে চলতে হবে। মানগুলো অবশ্যই নর্মালাইজড রেঞ্জের মধ্যে থাকতে হবে।

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

দ্রাঘিমাংশ ডিগ্রিতে। এটি অবশ্যই [-180.0, +180.0] সীমার মধ্যে হতে হবে।

রাজ্য

নির্বাচিত রুটের অবস্থা।

এনাম
STATE_UNSPECIFIED এই রুটের অবস্থা সেট করা নেই।
STATE_SCHEDULING রুটটি তৈরি করা হয়েছে এবং এর সময়সূচী নির্ধারণ করা হচ্ছে।
STATE_RUNNING রুটটি তৈরি করা হয়েছে এবং এর একটি সক্রিয় সময়সূচী রয়েছে।
STATE_DELETING রুটটি মুছে ফেলার জন্য চিহ্নিত করা হয়েছে।
STATE_VALIDATING রুটটি যাচাই করা হচ্ছে।
STATE_INVALID যাচাইকরণের একটি মানদণ্ডের ভিত্তিতে রুটটি অবৈধ।

বৈধতা ত্রুটি

নির্বাচিত রুটের জন্য যাচাইকরণ ত্রুটি।

এনাম
VALIDATION_ERROR_UNSPECIFIED এই রুটের ভ্যালিডেশন ত্রুটি সেট করা নেই।
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION পথটি প্রকল্পের আওতার বাইরে।
VALIDATION_ERROR_LOW_ROAD_USAGE এই পথটিতে সড়কের ব্যবহার কম (এখান দিয়ে খুব কম লোক যাতায়াত করে)।

পদ্ধতি

batchCreate

 একাধিক SelectedRoute রিসোর্স তৈরি করে এবং প্রতিটি রুটের জন্য পর্যায়ক্রমে ক্যাশ তথ্য পুনরুদ্ধার করার একটি সময়সূচী শুরু করে।

batchDelete

 নির্দিষ্ট প্রজেক্টের অন্তর্গত একাধিক SelectedRoute রিসোর্স মুছে ফেলে।

batchUpdate

 নাম অনুযায়ী একাধিক SelectedRoute রিসোর্স আপডেট করে।

create

 একটি SelectedRoute তৈরি করে এবং সেই রুটের জন্য পর্যায়ক্রমে ক্যাশে তথ্য পুনরুদ্ধার করার একটি সময়সূচী শুরু করে।

delete

 নির্দিষ্ট প্রজেক্টের জন্য নির্দিষ্ট SelectedRoute-টি মুছে দেয়।

get

 নাম অনুযায়ী একটি নির্বাচিত রুট পাওয়া যায়।

list

 নির্দিষ্ট প্রজেক্টের অন্তর্গত সমস্ত SelectedRoute রিসোর্স পেজিনেশন সহ তালিকাভুক্ত করে।

patch

 নাম অনুযায়ী একটি নির্বাচিত রুট আপডেট করে।