Method: computeRoutes

অনুরোধ করা ট্রাভেল মোডের জন্য অনুরোধ করা উৎস এবং গন্তব্যের মধ্যে প্রাথমিক রুট দেখায়।

HTTP অনুরোধ

POST https://mapstools.googleapis.com/v1:computeRoutes

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

অনুরোধের বডি

অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
ফিল্ড
origin

object (Waypoint)

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

object (Waypoint)

প্রয়োজনীয়। গন্তব্যের ওয়েপয়েন্ট।
travelMode

enum (RouteTravelMode)

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

object (Waypoint)

ঐচ্ছিক। যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে থাকা ইন্টারমিডিয়েট স্টপ, যেগুলি ক্রমানুসারে পার হতে হবে। সর্বাধিক ২৫টি ইন্টারমিডিয়েট ওয়েপয়েন্ট কাজ করে।

১০টির বেশি মধ্যবর্তী ওয়েপয়েন্ট উল্লেখ করলে খরচ ও লেটেন্সি বেশি হবে। travelMode, TRANSIT হলে মধ্যবর্তী ওয়েপয়েন্ট কাজ করে না।
routingPreference

enum (RoutingPreference)

ঐচ্ছিক। রুট গণনা করার জন্য ট্রাফিক ডেটা কীভাবে ব্যবহার করা হয় তা নির্ধারণ করে। travelMode-এর মান WALK বা BICYCLE হলে ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL কাজ করে না। TRANSIT-এর জন্য, এটি রিয়েল-টাইম ট্রানজিট ডেটা চালু করে, যেমন দেরি হওয়া এবং বাতিল করা।
locationBias

object (LatLng)

ঐচ্ছিক। সার্চ ফলাফলকে কোনও লোকেশনের দিকে পক্ষপাতদুষ্ট করতে, যেমন, ওয়েপয়েন্ট টেক্সট কোয়েরি থেকে অস্পষ্টতা দূর করতে।
includePolyline

boolean

ঐচ্ছিক। রেসপন্স রুটে এনকোড করা পলিলাইন অন্তর্ভুক্ত করা হবে কিনা। ডিফল্ট হিসেবে false সেট করা থাকে। true-এ সেট করা হলে, Route.encoded_polyline রিটার্ন করা হয়।
computeAlternativeRoutes

boolean

ঐচ্ছিক। সাজেস্ট করা রুট ছাড়াও বিকল্প রুট গণনা করা হবে কিনা। ডিফল্ট হিসেবে false সেট করা থাকে, সেক্ষেত্রে শুধু সাজেস্ট করা রুট দেখানো হয়। সত্য হিসেবে সেট করা হলে, উপলভ্য সব রুট দেখানো হয়, যদিও প্রতিটি অনুরোধের জন্য বিকল্প উপলভ্য নাও থাকতে পারে।
যাত্রা শুরু করার জায়গা থেকে কখন রওনা দিতে হবে বা গন্তব্যে কখন পৌঁছাতে হবে তা উল্লেখ করে। উল্লেখ করা না থাকলে, ডিফল্ট হিসেবে বর্তমান সময়ে রওনা হওয়ার সময় দেখানো হয়। TRANSIT-এর জন্য, সময়টি অবশ্যই অতীতে সর্বাধিক ৭ দিন এবং ভবিষ্যতে সর্বাধিক ১০০ দিন হতে হবে। অন্যান্য ট্রাভেল মোডের ক্ষেত্রে, সময়টি অবশ্যই অতীতের হতে পারবে না এবং ভবিষ্যতের সর্বাধিক ৩৬৫ দিনের মধ্যে হতে হবে। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
departureTime

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"।
arrivalTime

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"।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

প্রতিক্রিয়ার বডি

সফল হলে, প্রতিক্রিয়ার বডিতে একটি ComputeRoutesResponse-এর ইন্সট্যান্স থাকে।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.mapstools