Method: annotatePaths (Automotive)

পাথ বরাবর গতিশীল বৈশিষ্ট্যের জন্য টীকা সহ ইনপুট সেগমেন্ট-ভিত্তিক পাথ ফেরত দেয়।

HTTP অনুরোধ

POST https://routes.googleapis.com/annotations/v2:annotatePaths

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "paths": [
    {
      object (Path)
    }
  ],
  "annotationOptions": {
    object (AnnotationOptions)
  }
}
ক্ষেত্র
paths[]

object ( Path )

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

annotationOptions

object ( AnnotationOptions )

প্রয়োজন। অনুরোধ করা ডায়নামিক ডেটা অ্যাট্রিবিউট যা ইনপুট পাথগুলিতে যোগ করা উচিত। খালি থাকলে, অনুরোধটি টীকা করা হবে না।

প্রতিক্রিয়া শরীর

AnnotatePathsResponse-এ সমস্ত অনুরোধ করা টীকাগুলির জন্য অতিরিক্ত ডেটা যুক্ত ইনপুট পাথ রয়েছে৷

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "annotatedPaths": [
    {
      object (AnnotatedPath)
    }
  ]
}
ক্ষেত্র
annotatedPaths[]

object ( AnnotatedPath )

অনুরোধ করা গুণাবলী সহ টীকা ইনপুট থেকে পাথ.

পথ

একটি পাথ যেটিতে গতিশীল বৈশিষ্ট্যের অনুরোধ করা হচ্ছে৷

একটি পাথের সেগমেন্ট থাকা উচিত যা সংযুক্ত এবং চালনাযোগ্য। একটি পাথের সেগমেন্টগুলি একটি লজিক্যাল রুট অনুসরণ করে বলে ধরে নেওয়া হয়, এবং যদি ইনপুট সেগমেন্টগুলিতে একটি রুট পাওয়া না যায় তাহলে একটি ত্রুটি ফেরত দেওয়া হবে। উদাহরণস্বরূপ, যদি একটি পাথের সেগমেন্টে সংযোগকারী প্রান্তবিন্দু না থাকে, বা একটি পথ খালি থাকে, এটি একটি ত্রুটি তৈরি করে।

একটি পথ বর্তমানে 15 কিমি দীর্ঘ সীমাবদ্ধ। পথটি প্রথম সেগমেন্টের শুরু থেকে পরিমাপ করা হয়, অনুমান করা গাড়ির অবস্থান। প্রথম সেগমেন্টের শুরু থেকে 15 কিমি দূরে একটি পথের একটি অংশ শুরু হলে একটি ত্রুটি ফেরত দেওয়া হবে। এটি 15কিমি আগে শুরু হওয়া এবং 15কিমি এর পরে শেষ হওয়া শেষ অংশের জন্য গ্রহণযোগ্য। কোন আংশিক প্রতিক্রিয়া ফেরত দেওয়া হবে না.

একটি পাথ অন্য পাথের মতো একই সেগমেন্ট ধারণ করতে পারে, কিন্তু সেগমেন্টের টীকাগুলির জন্য পাথের অন্যান্য অংশের পার্থক্যের উপর ভিত্তি করে বিভিন্ন প্রতিক্রিয়া ধারণ করা সম্ভব।

JSON প্রতিনিধিত্ব
{
  "segments": [
    {
      object (Segment)
    }
  ]
}
ক্ষেত্র
segments[]

object ( Segment )

প্রয়োজন। সেগমেন্টের একটি অর্ডার করা তালিকা যা পথ তৈরি করে।

সেগমেন্ট

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

JSON প্রতিনিধিত্ব
{
  "polyline": {
    object (Polyline)
  },

  // Union field id can be only one of the following:
  "placeId": string
  // End of list of possible types for union field id.
}
ক্ষেত্র
polyline

object ( Polyline )

প্রয়োজন। সেগমেন্টের পলিলাইন, যেটি আইডি না পাওয়া গেলে সেগমেন্ট শনাক্ত করতে এবং একই আইডি থাকলে দুটি সেগমেন্টের মধ্যে পার্থক্য করতে ব্যবহার করা যেতে পারে। পলিলাইনটি স্ট্যান্ডার্ড Google ম্যাপ প্ল্যাটফর্ম এনকোডেড পলিলাইন অ্যালগরিদম ফর্ম্যাট ব্যবহার করে এনকোড করা হয়েছে।

ইউনিয়ন ফিল্ড id । একটি আইডি স্পেসের মধ্যে এই বিভাগটি সনাক্ত করার জন্য ব্যবহৃত হয়। প্রয়োজন। id নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
placeId

string

এই রাস্তার অংশের জন্য স্থান আইডি। APIs জুড়ে ব্যবহৃত।

টীকা বিকল্প

ইনপুট পাথের জন্য অনুরোধ করা টীকা৷

JSON প্রতিনিধিত্ব
{
  "includeLevelOfService": boolean
}
ক্ষেত্র
includeLevelOfService

boolean

ঐচ্ছিক। সত্য হিসাবে সেট করা হলে, প্রতিক্রিয়ার অংশগুলি পূর্বাভাসিত ট্র্যাফিক মান সহ টীকা করা হবে। ট্রাফিক প্রবাহের শ্রেণীবিভাগ বর্ণনা করার জন্য "পরিষেবার স্তর" একটি সাধারণভাবে ব্যবহৃত শব্দ, কিন্তু এই API-তে পরিষেবার সংজ্ঞার স্তর শুধুমাত্র এই API-এর অন্তর্গত।

টীকাযুক্তপথ

একটি ইনপুট পথের একটি অনুলিপি পূর্বাভাসিত গুণাবলী সহ ফিরে এসেছে৷

JSON প্রতিনিধিত্ব
{
  "annotatedSegments": [
    {
      object (AnnotatedSegment)
    }
  ]
}
ক্ষেত্র
annotatedSegments[]

object ( AnnotatedSegment )

সেগমেন্টের একটি অর্ডার করা তালিকা যা প্রধান পথ তৈরি করে, অনুরোধ করা গুণাবলী সহ টীকা।

টীকাযুক্ত সেগমেন্ট

একটি সেগমেন্ট যা একটি পাথ তৈরি করে, ডায়নামিক ডেটা অ্যাট্রিবিউট সহ টীকা।

JSON প্রতিনিধিত্ব
{
  "segment": {
    object (Segment)
  },
  "segmentSpanAttributes": [
    {
      object (SegmentSpanAttribute)
    }
  ]
}
ক্ষেত্র
segment

object ( Segment )

সেগমেন্টের বিবরণ অন্যান্য বিভাগ থেকে আলাদা করতে ব্যবহৃত হয়।

segmentSpanAttributes[]

object ( SegmentSpanAttribute )

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

সেগমেন্টস্প্যান অ্যাট্রিবিউট

একটি SegmentSpanAttribute এ API থেকে প্রত্যাবর্তিত টীকা ধারণ করে।

JSON প্রতিনিধিত্ব
{
  "segmentSpan": {
    object (SegmentSpan)
  },
  "levelOfService": enum (LevelOfService)
}
ক্ষেত্র
segmentSpan

object ( SegmentSpan )

সেগমেন্টে কোথায় টীকাগুলি প্রযোজ্য তা বর্ণনা করে৷

levelOfService

enum ( LevelOfService )

সেগমেন্ট স্প্যানের জন্য পূর্বাভাসিত ট্র্যাফিক স্তর, এই বিভাগে প্রত্যাশিত ট্র্যাফিক গতি দ্বারা সংজ্ঞায়িত করা হয় যখন গাড়িটি সেগমেন্টের শুরুতে আসে।

সেগমেন্টস্প্যান

একটি সেগমেন্টের একটি উপধারা সীমাবদ্ধ করতে ব্যবহৃত হয়। যদি একটি স্প্যান সমগ্র সেগমেন্টকে কভার করে, তাহলে স্টার্টমিটার হবে 0 এবং এন্ডমিটার হবে সেগমেন্টের দৈর্ঘ্য।

JSON প্রতিনিধিত্ব
{
  "startMeters": integer,
  "endMeters": integer
}
ক্ষেত্র
startMeters

integer

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

endMeters

integer

যেখানে স্প্যানের শেষটি সেগমেন্টের পলিলাইনের শুরু বিন্দু থেকে।

লেভেল অফ সার্ভিস

পূর্বাভাসিত ট্র্যাফিক বাকেট মান, ADAS কার্যকারিতার জন্য ব্যবহার করা হবে, যা ট্র্যাফিকের সাধারণ স্তরের মানচিত্র। এই API দ্বারা প্রত্যাবর্তিত মানগুলি স্বাধীন এবং অন্যান্য API-এর সাথে সঙ্গতিপূর্ণ হওয়ার জন্য নির্ভর করা উচিত নয়৷

Enums
LEVEL_OF_SERVICE_UNSPECIFIED ডিফল্ট মান। এই মানটির অর্থ হল কোনও পূর্বাভাসিত ট্র্যাফিক মান উপলব্ধ নেই৷
LEVEL_OF_SERVICE_STOPPED যান চলাচল বন্ধ রয়েছে।
LEVEL_OF_SERVICE_STOP_AND_GO যান চলাচল বন্ধ এবং যান.
LEVEL_OF_SERVICE_SLOW একটি ধীরগতির পূর্বাভাস দেওয়া হয়েছে, কিন্তু কোনো ট্রাফিক জ্যামের পূর্বাভাস নেই৷
LEVEL_OF_SERVICE_NORMAL স্বাভাবিক গতি, কোন ধীরগতির পূর্বাভাস নেই।