REST Resource: selection.v1.projects.selectedRoutes

Resource: SelectedRoute

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 response:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of mutually exclusive fields.
  "validationError": enum (ValidationError),
  "dynamicRouting": boolean
}
ফিল্ড
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 হলে, বেছে নেওয়া রুটের জন্য যাচাইকরণ সংক্রান্ত সমস্যা।
dynamicRouting

boolean

ঐচ্ছিক। true-এ সেট করা থাকলে, ইনপুট করা ওয়েপয়েন্ট অনুযায়ী লাইভ ট্রাফিকের উপর ভিত্তি করে বেছে নেওয়া রুটটি ডায়নামিকভাবে রি-রুট করা যেতে পারে। false-এ সেট করা হলে, বেছে নেওয়া রুটটি একটি নির্দিষ্ট রুট হবে যা লাইভ ট্রাফিক সম্পর্কে অজ্ঞ এবং তৈরি করার সময় গণনা করা ট্রাফিক-অজ্ঞাত পথ অনুসরণ করে। বাদ দেওয়া হলে, ডিফল্ট হিসেবে ভ্যালু false হবে, যা নির্দেশ করে যে এটি একটি নির্দিষ্ট রুট।

DynamicRoute

এটি ওয়েপয়েন্ট (শুরু, গন্তব্য ও মধ্যবর্তী স্থান) সহ রুট দেখায়। আসল রুটটি সমস্ত ওয়েপয়েন্ট অতিক্রম করবে বলে গ্যারেন্টি দেওয়া হয়েছে। dynamicRouting-এর মান false-এ সেট করা থাকলে, ট্রাফিক পরিস্থিতি যাই হোক না কেন, আসল রুট অপরিবর্তিত থাকে। অন্যথায়, dynamicRouting-এর মান true-এ সেট করা থাকলে, ট্রাফিক পরিস্থিতির উপর নির্ভর করে আসল রুট পরিবর্তন হতে পারে।

JSON উপস্থাপনা 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
ফিল্ড
origin

object (LatLng)

প্রয়োজনীয়। রুটের শুরুর লোকেশন।
destination

object (LatLng)

প্রয়োজনীয়। রুটের শেষ লোকেশন।
intermediates[]

object (LatLng)

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

LatLng

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

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ফিল্ড
latitude

number

ডিগ্রিতে অক্ষাংশ। এটি অবশ্যই [-৯০.০, +৯০.০] রেঞ্জের মধ্যে থাকতে হবে।
longitude

number

ডিগ্রিতে দ্রাঘিমাংশ। এটি অবশ্যই [-১৮০.০, +১৮০.০] রেঞ্জের মধ্যে হতে হবে।

রাজ্য

বেছে নেওয়া রুটের অবস্থা।

Enums
STATE_UNSPECIFIED এই রুটের অবস্থা সেট করা নেই।
STATE_SCHEDULING রুট তৈরি করা হয়েছে এবং শিডিউল করা হচ্ছে।
STATE_RUNNING রুট তৈরি করা হয়েছে এবং এটির একটি অ্যাক্টিভ শিডিউল আছে।
STATE_DELETING রুটটি মুছে ফেলার জন্য চিহ্নিত করা হয়েছে।
STATE_VALIDATING রুটটি যাচাই করার প্রক্রিয়া চলছে।
STATE_INVALID যাচাইকরণের কোনও একটি মাপকাঠির ভিত্তিতে রুটটি ভুল।

ValidationError

বেছে নেওয়া রুটের জন্য যাচাইকরণ সংক্রান্ত সমস্যা।

Enums
VALIDATION_ERROR_UNSPECIFIED এই রুটের যাচাইকরণ সংক্রান্ত সমস্যা সেট করা নেই।
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION রুটটি প্রোজেক্টের এক্তিয়ারের বাইরে।
VALIDATION_ERROR_LOW_ROAD_USAGE এই রুটে খুব কম লোক যাতায়াত করেন।

পদ্ধতি

batchCreate

 একাধিক SelectedRoute রিসোর্স তৈরি করে এবং প্রতিটি রুটের জন্য পর্যায়ক্রমে ক্যাশে তথ্য ফিরিয়ে আনার জন্য একটি শিডিউল শুরু করে।

batchDelete

 নির্দিষ্ট প্রোজেক্টের জন্য একাধিক SelectedRoute রিসোর্স মুছে দেয়।

batchUpdate

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

create

 SelectedRoute তৈরি করে এবং রুটের জন্য ক্যাশে তথ্য পর্যায়ক্রমে পুনরুদ্ধার করার জন্য একটি শিডিউল শুরু করে।

delete

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

get

 নাম অনুযায়ী নির্দিষ্ট করা SelectedRoute পায়।

list

 পৃষ্ঠা সংখ্যা সহ নির্দিষ্ট প্রোজেক্টের জন্য সব SelectedRoute রিসোর্স তালিকাভুক্ত করে।

patch

 নাম অনুযায়ী নির্দিষ্ট করা SelectedRoute আপডেট করে।