রুট API বর্তমানে পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

Method: computeRoutes

টার্মিনাল এবং মধ্যবর্তী ওয়েপয়েন্টের একটি সেট দেওয়া ঐচ্ছিক বিকল্প রুটের সাথে প্রাথমিক রুট প্রদান করে।

দ্রষ্টব্য: এই পদ্ধতির জন্য আপনাকে ইনপুটে একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক নির্দিষ্ট করতে হবে। আপনি URL প্যারামিটার $fields বা fields ব্যবহার করে প্রতিক্রিয়া ক্ষেত্র মাস্ক প্রদান করতে পারেন, অথবা একটি HTTP/gRPC হেডার X-Goog-FieldMask ব্যবহার করে ( উপলব্ধ URL প্যারামিটার এবং শিরোনাম দেখুন। মান হল ফিল্ড পাথগুলির একটি কমা বিভক্ত তালিকা। দেখুন ক্ষেত্র পাথ কিভাবে নির্মাণ করতে হয় সে সম্পর্কে বিস্তারিত ডকুমেন্টেশন।

উদাহরণস্বরূপ, এই পদ্ধতিতে:

  • সমস্ত উপলব্ধ ক্ষেত্রের ফিল্ড মাস্ক (ম্যানুয়াল পরিদর্শনের জন্য): X-Goog-FieldMask: *
  • রুট-স্তরের সময়কাল, দূরত্ব এবং পলিলাইনের ফিল্ড মাস্ক (একটি উদাহরণ উত্পাদন সেটআপ): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google ওয়াইল্ডকার্ড ( * ) প্রতিক্রিয়া ফিল্ড মাস্ক ব্যবহার করতে নিরুৎসাহিত করে, বা শীর্ষ স্তরে ফিল্ড মাস্ক নির্দিষ্ট করে ( routes ), কারণ:

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

HTTP অনুরোধ

POST https://routes.googleapis.com/directions/v2:computeRoutes

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

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

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

JSON প্রতিনিধিত্ব
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "units": enum (Units),
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ]
}
ক্ষেত্র
origin

object ( Waypoint )

প্রয়োজন। মূল পথপয়েন্ট।

destination

object ( Waypoint )

প্রয়োজন। গন্তব্য পথপয়েন্ট।

intermediates[]

object ( Waypoint )

ঐচ্ছিক। রুট বরাবর ওয়েপয়েন্টের একটি সেট (টার্মিনাল পয়েন্ট বাদে), হয় থামার জন্য বা পাশ দিয়ে যাওয়ার জন্য। 25টি পর্যন্ত মধ্যবর্তী ওয়েপয়েন্ট সমর্থিত।

travelMode

enum ( RouteTravelMode )

ঐচ্ছিক। পরিবহনের মোড নির্দিষ্ট করে।

routingPreference

enum ( RoutingPreference )

ঐচ্ছিক। রুট গণনা কিভাবে নির্দিষ্ট করে. সার্ভার রুট গণনা করার জন্য নির্বাচিত রাউটিং পছন্দ ব্যবহার করার চেষ্টা করে। যদি রাউটিং পছন্দ একটি ত্রুটি বা একটি অতিরিক্ত দীর্ঘ লেটেন্সি ফলাফল, তারপর একটি ত্রুটি ফেরত হয়. আপনি এই বিকল্পটি শুধুমাত্র তখনই নির্দিষ্ট করতে পারেন যখন TWO_WHEELER DRIVE বা travelMode হয়, অন্যথায় অনুরোধটি ব্যর্থ হয়।

polylineQuality

enum ( PolylineQuality )

ঐচ্ছিক। পলিলাইনের মানের জন্য আপনার পছন্দ নির্দিষ্ট করে।

polylineEncoding

enum ( PolylineEncoding )

ঐচ্ছিক। পলিলাইনের জন্য পছন্দের এনকোডিং নির্দিষ্ট করে।

departureTime

string ( Timestamp format)

ঐচ্ছিক। প্রস্থানের সময়। আপনি যদি এই মানটি সেট না করেন, তাহলে এই মানটি আপনার অনুরোধ করার সময় ডিফল্ট হবে। যদি আপনি এই মানটি এমন একটি সময়ে সেট করেন যা ইতিমধ্যেই ঘটেছে, তাহলে অনুরোধটি ব্যর্থ হবে।

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

computeAlternativeRoutes

boolean

ঐচ্ছিক। রুট ছাড়াও বিকল্প রুট গণনা করতে হবে কিনা তা নির্দিষ্ট করে।

routeModifiers

object ( RouteModifiers )

ঐচ্ছিক। সন্তুষ্ট করার শর্তের একটি সেট যা রুট গণনা করার পদ্ধতিকে প্রভাবিত করে।

languageCode

string

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

units

enum ( Units )

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

requestedReferenceRoutes[]

enum ( ReferenceRoute )

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

extraComputations[]

enum ( ExtraComputation )

ঐচ্ছিক। অতিরিক্ত গণনার একটি তালিকা যা অনুরোধটি সম্পূর্ণ করতে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই অতিরিক্ত গণনাগুলি প্রতিক্রিয়াতে অতিরিক্ত ক্ষেত্রগুলি ফিরিয়ে দিতে পারে। এই অতিরিক্ত ক্ষেত্রগুলি অবশ্যই প্রতিক্রিয়াতে ফেরত দেওয়ার জন্য ফিল্ড মাস্কে নির্দিষ্ট করতে হবে।

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

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

v2.compute প্রতিক্রিয়া বার্তাটি রুট করে।

JSON প্রতিনিধিত্ব
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  }
}
ক্ষেত্র
routes[]

object ( Route )

আপনি compute_alternatives_routes নির্দিষ্ট করার সময় গণনা করা রুটের একটি অ্যারে (তিনটি পর্যন্ত) ধারণ করে এবং যখন আপনি না করেন তখন শুধুমাত্র একটি রুট থাকে। যখন এই অ্যারেতে একাধিক এন্ট্রি থাকে, প্রথমটি সবচেয়ে প্রস্তাবিত রুট। যদি অ্যারে খালি থাকে, তাহলে এর মানে কোনো রুট পাওয়া যায়নি।

fallbackInfo

object ( FallbackInfo )

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

পলিলাইন কোয়ালিটি

মানগুলির একটি সেট যা পলিলাইনের গুণমান নির্দিষ্ট করে৷

Enums
POLYLINE_QUALITY_UNSPECIFIED কোনো পলিলাইন মানের পছন্দ নির্দিষ্ট করা নেই। OVERVIEW ডিফল্ট।
HIGH_QUALITY একটি উচ্চ-মানের পলিলাইন নির্দিষ্ট করে - যা বর্ধিত প্রতিক্রিয়া আকারের খরচে OVERVIEW -এর চেয়ে বেশি পয়েন্ট ব্যবহার করে তৈরি করা হয়। আপনার যখন আরও নির্ভুলতা প্রয়োজন তখন এই মানটি ব্যবহার করুন।
OVERVIEW একটি ওভারভিউ পলিলাইন নির্দিষ্ট করে - যা অল্প সংখ্যক পয়েন্ট ব্যবহার করে তৈরি করা হয়। রুটের একটি ওভারভিউ প্রদর্শন করার সময় এই মানটি ব্যবহার করুন। HIGH_QUALITY বিকল্পটি ব্যবহার করার তুলনায় এই বিকল্পটি ব্যবহার করার অনুরোধের বিলম্ব কম।

পলিলাইন এনকোডিং

প্রত্যাবর্তনের জন্য পছন্দসই ধরণের পলিলাইন নির্দিষ্ট করে।

Enums
POLYLINE_ENCODING_UNSPECIFIED কোন পলিলাইন টাইপ পছন্দ নির্দিষ্ট করা নেই। ENCODED_POLYLINE ডিফল্ট।
ENCODED_POLYLINE পলিলাইন এনকোডিং অ্যালগরিদম ব্যবহার করে একটি পলিলাইন এনকোড করা নির্দিষ্ট করে৷
GEO_JSON_LINESTRING GeoJSON LineString বিন্যাস ব্যবহার করে একটি পলিলাইন নির্দিষ্ট করে

ইউনিট

মানগুলির একটি সেট যা প্রদর্শনে ব্যবহৃত পরিমাপের একক নির্দিষ্ট করে।

Enums
UNITS_UNSPECIFIED পরিমাপের একক নির্দিষ্ট করা নেই। অনুরোধ থেকে অনুমান করা পরিমাপের ইউনিটে ডিফল্ট।
METRIC পরিমাপের মেট্রিক একক।
IMPERIAL ইম্পেরিয়াল (ইংরেজি) পরিমাপের একক।

রেফারেন্স রুট

ComputeRoutesRequest এ একটি সমর্থিত রেফারেন্স রুট।

Enums
REFERENCE_ROUTE_UNSPECIFIED ব্যবহার করা হয় না. এই মান ধারণকারী অনুরোধ ব্যর্থ হয়.
FUEL_EFFICIENT জ্বালানি সাশ্রয়ী পথ। এই মান সহ লেবেলযুক্ত রুটগুলি জ্বালানী খরচের মতো পরামিতিগুলির জন্য অপ্টিমাইজ করার জন্য নির্ধারিত হয়৷

এক্সট্রা কম্পিউটেশন

অনুরোধ সম্পূর্ণ করার সময় সঞ্চালনের জন্য অতিরিক্ত গণনা।

Enums
EXTRA_COMPUTATION_UNSPECIFIED ব্যবহার করা হয় না. এই মান ধারণকারী অনুরোধ ব্যর্থ হবে.
TOLLS রুট(গুলি) জন্য টোল তথ্য।
FUEL_CONSUMPTION রুট(গুলি) জন্য আনুমানিক জ্বালানী খরচ।
TRAFFIC_ON_POLYLINE রুট(গুলি) জন্য ট্রাফিক সচেতন পলিলাইন

রুট

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

JSON প্রতিনিধিত্ব
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "routeToken": string
}
ক্ষেত্র
routeLabels[]

enum ( RouteLabel )

Route লেবেল যা অন্যদের সাথে তুলনা করার জন্য রুটের নির্দিষ্ট বৈশিষ্ট্য সনাক্ত করতে উপযোগী।

legs[]

object ( RouteLeg )

পায়ের একটি সংগ্রহ (ওয়েপয়েন্টের মধ্যে পথের অংশ) যা রুট তৈরি করে। প্রতিটি পা দুটি নন- ওয়েপয়েন্টের via ভ্রমণের সাথে মিলে যায়। উদাহরণস্বরূপ, কোনো মধ্যবর্তী পথবিন্দু ছাড়া একটি রুটের একটি মাত্র পা থাকে। একটি রুট যাতে একটি অ-এর via মধ্যবর্তী পথপয়েন্টের দুটি পা থাকে। একটি রুট যা মধ্যবর্তী পথপয়েন্টের via একটি অন্তর্ভুক্ত করে তার একটি পা থাকে। পায়ের ক্রম origin থেকে destination পর্যন্ত intermediates স্থানের ওয়েপয়েন্টের ক্রমটির সাথে মেলে।

distanceMeters

integer

রুটের ভ্রমণ দূরত্ব, মিটারে।

duration

string ( Duration format)

রুট নেভিগেট করার জন্য প্রয়োজনীয় সময়ের দৈর্ঘ্য। আপনি যদি রাউটিং পছন্দটি TRAFFIC_UNAWARE তে সেট করেন, তাহলে এই মানটি routingPreference এর staticDuration । আপনি যদি routingPreference TRAFFIC_AWARE বা TRAFFIC_AWARE_OPTIMAL তে সেট করেন, তাহলে এই মানটি ট্রাফিক পরিস্থিতি বিবেচনা করে গণনা করা হয়।

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

staticDuration

string ( Duration format)

ট্রাফিক পরিস্থিতি বিবেচনায় না নিয়ে রুট দিয়ে ভ্রমণের সময়কাল।

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

polyline

object ( Polyline )

সামগ্রিক রুট পলিলাইন. এই পলিলাইন হবে সব legs মিলিত পলিলাইন।

description

string

পথের বর্ণনা।

warnings[]

string

রুট প্রদর্শন করার সময় দেখানোর জন্য সতর্কতার একটি অ্যারে।

viewport

object ( Viewport )

পলিলাইনের ভিউপোর্ট বাউন্ডিং বক্স।

travelAdvisory

object ( RouteTravelAdvisory )

রুট সম্পর্কে অতিরিক্ত তথ্য.

routeToken

string

ওয়েব-সেফ বেস64 এনকোড করা রুট টোকেন যা নেভিগেশনএসডিকে-তে পাস করা যেতে পারে, যা নেভিগেশন SDK-কে নেভিগেশনের সময় রুট পুনর্গঠন করতে দেয় এবং রুট v2.computeRoutes কল করা হলে মূল উদ্দেশ্যকে সম্মান করে। গ্রাহকদের এই টোকেনটিকে একটি অস্বচ্ছ ব্লব হিসাবে বিবেচনা করা উচিত। দ্রষ্টব্য: Route.route_token শুধুমাত্র সেই অনুরোধগুলির জন্য উপলব্ধ যা ComputeRoutesRequest.routing_preference কে TRAFFIC_AWARE বা TRAFFIC_AWARE_OPTIMAL তে সেট করেছে। Route.route_token এছাড়াও ওয়েপয়েন্টের মাধ্যমে অনুরোধের জন্য সমর্থিত নয়।

রুটলেবেল

Route লেবেল যা অন্যদের সাথে তুলনা করার জন্য রুটের নির্দিষ্ট বৈশিষ্ট্য সনাক্ত করতে উপযোগী।

Enums
ROUTE_LABEL_UNSPECIFIED ডিফল্ট - ব্যবহৃত হয় না।
DEFAULT_ROUTE রুট গণনার জন্য ডিফল্ট "সেরা" রুটটি ফিরে এসেছে।
DEFAULT_ROUTE_ALTERNATE ডিফল্ট "সেরা" রুটের বিকল্প। ComputeRoutesRequest.compute_alternative_routes নির্দিষ্ট করা হলে এই ধরনের রুট ফেরত দেওয়া হবে।
FUEL_EFFICIENT জ্বালানি সাশ্রয়ী পথ। এই মান সহ লেবেল করা রুটগুলি ইকো প্যারামিটার যেমন জ্বালানী খরচের জন্য অপ্টিমাইজ করা হবে বলে নির্ধারিত হয়৷

রুটলেগ

নন- via মধ্যে একটি সেগমেন্টকে এনক্যাপসুলেট করে।

JSON প্রতিনিধিত্ব
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
ক্ষেত্র
distanceMeters

integer

রুট লেগের ভ্রমণ দূরত্ব, মিটারে।

duration

string ( Duration format)

পায়ে নেভিগেট করার জন্য প্রয়োজনীয় সময়ের দৈর্ঘ্য। যদি route_preference TRAFFIC_UNAWARE তে সেট করা হয়, তাহলে এই মানটি staticDuration এর মতই। যদি route_preference হয় TRAFFIC_AWARE বা TRAFFIC_AWARE_OPTIMAL , তাহলে এই মানটি ট্রাফিক পরিস্থিতি বিবেচনা করে গণনা করা হয়৷

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

staticDuration

string ( Duration format)

পায়ের মধ্য দিয়ে ভ্রমণের সময়কাল, ট্রাফিক পরিস্থিতি বিবেচনায় না নিয়ে গণনা করা হয়।

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

polyline

object ( Polyline )

এই পায়ের জন্য সামগ্রিক পলিলাইন। এর মধ্যে রয়েছে প্রতিটি step পলিলাইন।

startLocation

object ( Location )

এই পায়ের শুরুর অবস্থান। এটি প্রদত্ত origin থেকে ভিন্ন হতে পারে। উদাহরণস্বরূপ, যখন প্রদত্ত origin একটি রাস্তার কাছাকাছি নয়, এটি রাস্তার একটি বিন্দু।

endLocation

object ( Location )

এই পায়ের শেষ অবস্থান। এটি প্রদত্ত destination থেকে ভিন্ন হতে পারে। উদাহরণস্বরূপ, যখন প্রদত্ত destination রাস্তার কাছাকাছি না থাকে, তখন এটি রাস্তার একটি বিন্দু।

steps[]

object ( RouteLegStep )

এই পায়ের মধ্যে অংশগুলিকে নির্দেশ করে ধাপগুলির একটি অ্যারে৷ প্রতিটি ধাপ একটি নেভিগেশন নির্দেশ প্রতিনিধিত্ব করে।

travelAdvisory

object ( RouteLegTravelAdvisory )

ব্যবহারকারীকে যে অতিরিক্ত তথ্য সম্পর্কে অবহিত করা উচিত, যেমন সম্ভাব্য ট্র্যাফিক জোন সীমাবদ্ধতা প্রভৃতি একটি রুট লেগ এ এনক্যাপসুলেট করে৷

পলিলাইন

একটি এনকোডেড পলিলাইন এনক্যাপসুলেট করে।

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

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড polyline_type । পলিলাইনের প্রকারকে এনক্যাপসুলেট করে। এনকোডেড_পলিলাইনে ডিফল্ট। polyline_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
encodedPolyline

string

পলিলাইন এনকোডিং অ্যালগরিদম ব্যবহার করে পলিলাইনের স্ট্রিং এনকোডিং

geoJsonLinestring

object ( Struct format)

GeoJSON LineString বিন্যাস ব্যবহার করে একটি পলিলাইন নির্দিষ্ট করে

রুটলেগ স্টেপ

একটি RouteLeg এর একটি অংশকে এনক্যাপসুলেট করে। একটি ধাপ একটি একক নেভিগেশন নির্দেশের সাথে মিলে যায়। রুট পা ধাপে গঠিত হয়.

JSON প্রতিনিধিত্ব
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
ক্ষেত্র
distanceMeters

integer

এই ধাপের ভ্রমণ দূরত্ব, মিটারে। কিছু পরিস্থিতিতে, এই ক্ষেত্রের একটি মান নাও থাকতে পারে।

staticDuration

string ( Duration format)

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

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

polyline

object ( Polyline )

এই ধাপের সাথে যুক্ত পলিলাইন।

startLocation

object ( Location )

এই ধাপের শুরুর অবস্থান।

endLocation

object ( Location )

এই ধাপের শেষ অবস্থান।

navigationInstruction

object ( NavigationInstruction )

নেভিগেশন নির্দেশাবলী.

travelAdvisory

object ( RouteLegStepTravelAdvisory )

অতিরিক্ত তথ্য এনক্যাপসুলেট করে যা ব্যবহারকারীকে জানানো উচিত, যেমন একটি পায়ে ধাপে সম্ভাব্য ট্রাফিক জোন সীমাবদ্ধতা।

কৌশল

মানগুলির একটি সেট যা বর্তমান পদক্ষেপের জন্য নেভিগেশন অ্যাকশনটি নির্দিষ্ট করে (যেমন, বাম দিকে ঘুরুন, মার্জ করুন, সোজা, ইত্যাদি)।

Enums
MANEUVER_UNSPECIFIED ব্যবহার করা হয় না.
TURN_SLIGHT_LEFT একটু বাম দিকে ঘুরুন।
TURN_SHARP_LEFT তীক্ষ্ণভাবে বাম দিকে ঘুরুন।
UTURN_LEFT একটি বাম ইউ-টার্ন করুন।
TURN_LEFT বাম দিকে ঘুরুন।
TURN_SLIGHT_RIGHT একটু ডানদিকে ঘুরুন।
TURN_SHARP_RIGHT তীক্ষ্ণভাবে ডানদিকে ঘুরুন।
UTURN_RIGHT একটি ডান ইউ-টার্ন করুন.
TURN_RIGHT ডানে ঘোরা.
STRAIGHT সোজা যাও.
RAMP_LEFT বাম র‌্যাম্প ধরুন।
RAMP_RIGHT ডান র‌্যাম্প নিন।
MERGE ট্রাফিকের মধ্যে একত্রিত.
FORK_LEFT বাম কাঁটা নিন।
FORK_RIGHT ডান কাঁটাচামচ নিন.
FERRY ফেরি নিন।
FERRY_TRAIN ফেরিতে যাওয়ার ট্রেন ধরুন।
ROUNDABOUT_LEFT গোলচক্কর থেকে বাম দিকে ঘুরুন।
ROUNDABOUT_RIGHT গোলচক্কর থেকে ডান দিকে ঘুরুন।

RouteLegStepTravelAdvisory

অতিরিক্ত তথ্য এনক্যাপসুলেট করে যা ব্যবহারকারীকে জানানো উচিত, যেমন একটি পায়ে ধাপে সম্ভাব্য ট্রাফিক জোন সীমাবদ্ধতা।

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

object ( SpeedReadingInterval )

ট্র্যাফিক ঘনত্বের বিশদ বিবরণ দিয়ে গতি পড়ার ব্যবধান। TRAFFIC_AWARE এবং TRAFFIC_AWARE_OPTIMAL রাউটিং পছন্দগুলির ক্ষেত্রে প্রযোজ্য৷ বিরতিগুলি ওভারল্যাপ ছাড়াই RouteLegStep-এর সম্পূর্ণ পলিলাইনকে কভার করে। একটি নির্দিষ্ট ব্যবধানের শুরু বিন্দু পূর্ববর্তী ব্যবধানের শেষ বিন্দুর সমান।

উদাহরণ:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegTravel Advisory

ব্যবহারকারীকে যে অতিরিক্ত তথ্য সম্পর্কে অবহিত করা উচিত, যেমন সম্ভাব্য ট্র্যাফিক জোন সীমাবদ্ধতা প্রভৃতি একটি রুট লেগ এ এনক্যাপসুলেট করে৷

JSON প্রতিনিধিত্ব
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
ক্ষেত্র
tollInfo

object ( TollInfo )

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

speedReadingIntervals[]

object ( SpeedReadingInterval )

ট্র্যাফিক ঘনত্বের বিশদ বিবরণ দিয়ে গতি পড়ার ব্যবধান। TRAFFIC_AWARE এবং TRAFFIC_AWARE_OPTIMAL রাউটিং পছন্দগুলির ক্ষেত্রে প্রযোজ্য৷ বিরতিগুলি ওভারল্যাপ ছাড়াই RouteLg-এর সম্পূর্ণ পলিলাইনকে কভার করে। একটি নির্দিষ্ট ব্যবধানের শুরু বিন্দু পূর্ববর্তী ব্যবধানের শেষ বিন্দুর সমান।

উদাহরণ:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

ভিউপোর্ট

একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, দুটি তির্যক বিপরীত low এবং high বিন্দু হিসাবে উপস্থাপিত। একটি ভিউপোর্টকে একটি বন্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, অর্থাৎ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই -90 থেকে 90 ডিগ্রী সহ, এবং দ্রাঘিমাংশের সীমাগুলি অবশ্যই -180 থেকে 180 ডিগ্রী সহ এর মধ্যে হতে হবে৷ বিভিন্ন ক্ষেত্রে অন্তর্ভুক্ত:

  • low = high হলে, ভিউপোর্টটি সেই একক বিন্দু নিয়ে গঠিত।

  • low.longitude > high.longitude হলে, দ্রাঘিমাংশের সীমাটি উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশের রেখা অতিক্রম করে)।

  • low.longitude = -180 ডিগ্রি এবং high.longitude = 180 ডিগ্রি হলে, ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।

  • low.longitude = 180 ডিগ্রি এবং high.longitude দ্রাঘিমাংশ = -180 ডিগ্রি হলে, দ্রাঘিমাংশের পরিসর খালি।

  • low.latitude > high.latitude হলে, অক্ষাংশ পরিসর খালি থাকে।

low এবং high উভয়ই জনবসতিপূর্ণ হতে হবে এবং উপস্থাপিত বাক্সটি খালি হতে পারে না (উপরের সংজ্ঞা দ্বারা নির্দিষ্ট করা হয়েছে)। একটি খালি ভিউপোর্ট একটি ত্রুটির কারণ হবে.

উদাহরণস্বরূপ, এই ভিউপোর্টটি সম্পূর্ণরূপে নিউ ইয়র্ক সিটিকে ঘিরে রেখেছে:

{ "নিম্ন": { "অক্ষাংশ": 40.477398, "দ্রাঘিমাংশ": -74.259087 }, "উচ্চ": { "অক্ষাংশ": 40.91618, "দ্রাঘিমাংশ": -73.70018 } }

JSON প্রতিনিধিত্ব
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ক্ষেত্র
low

object ( LatLng )

প্রয়োজন। ভিউপোর্টের নিম্ন পয়েন্ট।

high

object ( LatLng )

প্রয়োজন। ভিউপোর্টের উচ্চ বিন্দু।