রুট প্রতিক্রিয়া পর্যালোচনা

যখন Routes API একটি রুট গণনা করে, তখন এটি আপনার প্রদত্ত ওয়েপয়েন্ট এবং কনফিগারেশন প্যারামিটারগুলিকে ইনপুট হিসেবে নেয়। API তারপর একটি প্রতিক্রিয়া প্রদান করে যাতে ডিফল্ট রুট এবং এক বা একাধিক বিকল্প রুট থাকে।

আপনার অনুরোধকৃত ক্ষেত্রগুলির উপর ভিত্তি করে, আপনার প্রতিক্রিয়ায় বিভিন্ন ধরণের রুট এবং অন্যান্য ডেটা অন্তর্ভুক্ত থাকতে পারে:

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

প্রতিক্রিয়া ব্যবহার করে, আপনি আপনার গ্রাহকদের তাদের প্রয়োজনীয়তার জন্য উপযুক্ত রুট নির্বাচন করার জন্য প্রয়োজনীয় তথ্য সরবরাহ করতে পারেন।

ফিল্ড মাস্ক সম্পর্কে

যখন আপনি একটি রুট গণনা করার জন্য একটি পদ্ধতি কল করেন, তখন আপনাকে একটি ফিল্ড মাস্ক নির্দিষ্ট করতে হবে যা নির্ধারণ করে যে আপনি প্রতিক্রিয়ায় কোন ক্ষেত্রগুলি ফেরত চান। ফেরত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই। যদি আপনি এই তালিকাটি বাদ দেন, তাহলে পদ্ধতিগুলি একটি ত্রুটি ফেরত পাঠাবে।

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

আরও তথ্যের জন্য, কোন তথ্য ফেরত দেবেন তা চয়ন করুন দেখুন।

কপিরাইট প্রদর্শন সম্পর্কে

আপনার ব্যবহারকারীদের কাছে ফলাফল প্রদর্শন করার সময় আপনাকে নিম্নলিখিত কপিরাইট বিবৃতিটি অন্তর্ভুক্ত করতে হবে:

Powered by Google, © YEAR Google

উদাহরণস্বরূপ:

Powered by Google, ©2023 Google

রুট, পা এবং ধাপ সম্পর্কে

Routes API দ্বারা প্রদত্ত প্রতিক্রিয়া দেখার আগে, আপনার একটি রুট তৈরির উপাদানগুলি সম্পর্কে ধারণা থাকা উচিত:

আপনার প্রতিক্রিয়ায় এই রুট উপাদানগুলির প্রতিটি সম্পর্কে তথ্য থাকতে পারে:

• রুট : উৎপত্তিস্থল থেকে শুরু করে যেকোনো মধ্যবর্তী পথের মধ্য দিয়ে গন্তব্যস্থলে পৌঁছানোর পুরো যাত্রা। একটি রুট এক বা একাধিক পা নিয়ে গঠিত।

• লেগ : একটি রুটের এক ওয়েপয়েন্ট থেকে অন্য ওয়েপয়েন্টে যাওয়ার পথ। প্রতিটি লেগে এক বা একাধিক বিচ্ছিন্ন ধাপ থাকে।

  একটি রুটে প্রতিটি ওয়েপয়েন্ট থেকে অন্য ওয়েপয়েন্টে যাওয়ার জন্য একটি পৃথক লেগ থাকে। উদাহরণস্বরূপ, যদি রুটে একটি একক অরিজিন ওয়েপয়েন্ট এবং একটি একক গন্তব্য ওয়েপয়েন্ট থাকে, তাহলে রুটে একটি একক লেগ থাকে। অরিজিন এবং গন্তব্যের পরে রুটে যোগ করা প্রতিটি অতিরিক্ত ওয়েপয়েন্টের জন্য, যাকে ইন্টারমিডিয়েট ওয়েপয়েন্ট বলা হয়, API একটি পৃথক লেগ যোগ করে।

  API একটি পাস-থ্রু ইন্টারমিডিয়েট ওয়েপয়েন্টের জন্য কোনও লেগ যোগ করে না। উদাহরণস্বরূপ, একটি রুট যেখানে একটি অরিজিন ওয়েপয়েন্ট, একটি পাস-থ্রু ইন্টারমিডিয়েট ওয়েপয়েন্ট এবং একটি গন্তব্য ওয়েপয়েন্টে ওয়েপয়েন্টের মধ্য দিয়ে যাওয়ার সময়, উৎপত্তিস্থল থেকে গন্তব্যস্থলে পৌঁছানোর জন্য কেবল একটি লেগ থাকে। পাস-থ্রু ওয়েপয়েন্ট সম্পর্কে আরও তথ্যের জন্য, একটি পাস-থ্রু ওয়েপয়েন্ট সংজ্ঞায়িত করুন দেখুন।

• ধাপ : একটি রুটের লেগ বরাবর একটি একক নির্দেশ। একটি ধাপ হল একটি রুটের সবচেয়ে পারমাণবিক একক। উদাহরণস্বরূপ, একটি ধাপ "প্রধান রাস্তায় বাম দিকে ঘুরুন" নির্দেশ করতে পারে।

উত্তরে কী আছে?

API প্রতিক্রিয়া প্রতিনিধিত্বকারী JSON অবজেক্টে নিম্নলিখিত শীর্ষ-স্তরের বৈশিষ্ট্য রয়েছে:

• routes , Route ধরণের উপাদানের একটি অ্যারে। routes অ্যারেতে API দ্বারা ফেরত পাঠানো প্রতিটি রুটের জন্য একটি উপাদান থাকে। অ্যারেতে সর্বাধিক পাঁচটি উপাদান থাকতে পারে: ডিফল্ট রুট, পরিবেশ বান্ধব রুট এবং সর্বাধিক তিনটি বিকল্প রুট।

• geocodingResults , GeocodingResults ধরণের উপাদানের একটি অ্যারে। অনুরোধের প্রতিটি অবস্থানের জন্য (মূল, গন্তব্য, বা মধ্যবর্তী ওয়েপয়েন্ট) যা আপনি ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে নির্দিষ্ট করেছেন, API একটি স্থান আইডি লুকআপ করে। এই অ্যারের প্রতিটি উপাদানে একটি অবস্থানের সাথে সম্পর্কিত স্থান আইডি থাকে। অনুরোধে স্থান আইডি বা অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক হিসাবে নির্দিষ্ট অবস্থানগুলি অন্তর্ভুক্ত করা হয় না। আপনি যদি স্থান আইডি বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে সমস্ত অবস্থান নির্দিষ্ট করে থাকেন, তবে এই অ্যারেটি সরবরাহ করা হয় না।

• fallbackInfo , FallbackInfo টাইপের। যদি API সমস্ত ইনপুট বৈশিষ্ট্য থেকে একটি রুট গণনা করতে সক্ষম না হয়, তাহলে এটি গণনার একটি ভিন্ন পদ্ধতি ব্যবহার করে ফিরে যেতে পারে। যখন ফলব্যাক মোড ব্যবহার করা হয়, তখন এই ক্ষেত্রটিতে ফলব্যাক প্রতিক্রিয়া সম্পর্কে বিস্তারিত তথ্য থাকে। অন্যথায় এই ক্ষেত্রটি সেট করা নেই।

প্রতিক্রিয়াটির রূপ হল:

{
  // The routes array.
  "routes": [
    {
      object (Route)
    }
  ],
  // The place ID lookup results.
  "geocodingResults": [
    {
      object (GeocodedWaypoint)
    }
  ],
  // The fallback property.
  "fallbackInfo": {
    object (FallbackInfo)
  }
}

রুট অ্যারের পাঠোদ্ধার করুন

প্রতিক্রিয়াটিতে routes অ্যারে থাকে, যেখানে প্রতিটি অ্যারে উপাদান Route ধরণের। প্রতিটি অ্যারে উপাদান উৎপত্তিস্থল থেকে গন্তব্যস্থলে একটি সম্পূর্ণ রুট উপস্থাপন করে। API সর্বদা কমপক্ষে একটি রুট প্রদান করে, যাকে ডিফল্ট রুট বলা হয়।

আপনি অতিরিক্ত রুট অনুরোধ করতে পারেন। যদি আপনি একটি পরিবেশ-বান্ধব রুট অনুরোধ করেন, তাহলে অ্যারেতে দুটি উপাদান থাকতে পারে: ডিফল্ট রুট এবং পরিবেশ-বান্ধব রুট। অথবা, প্রতিক্রিয়ায় তিনটি বিকল্প রুট যোগ করার জন্য অনুরোধে computeAlternativeRoutes true তে সেট করুন।

অ্যারের প্রতিটি রুট routeLabels অ্যারে প্রোপার্টি দিয়ে চিহ্নিত করা হয়:

legs অ্যারেতে রুটের প্রতিটি লেগের সংজ্ঞা থাকে। বাকি বৈশিষ্ট্যগুলি, যেমন distanceMeters , duration , এবং polyline, সম্পূর্ণ রুট সম্পর্কে তথ্য ধারণ করে:

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "routeLabels": [string],
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  }
  "routeToken": string
}

বর্তমান ড্রাইভিং পরিস্থিতি এবং অন্যান্য কারণের কারণে, ডিফল্ট রুট এবং পরিবেশ বান্ধব রুট একই হতে পারে। এই ক্ষেত্রে, routeLabels অ্যারেতে দুটি লেবেলই থাকে: DEFAULT_ROUTE এবং FUEL_EFFICIENT ।

{
  "routes": [
    {
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ],
     …
    }
  ]
}

পায়ের অ্যারে বুঝুন

প্রতিক্রিয়ার প্রতিটি route একটি legs অ্যারে থাকে, যেখানে প্রতিটি legs অ্যারে উপাদান RouteLeg ধরণের। অ্যারের প্রতিটি লেগ রুট বরাবর একটি ওয়েপয়েন্ট থেকে পরবর্তী ওয়েপয়েন্টে যাওয়ার পথ নির্ধারণ করে। একটি রুটে সর্বদা কমপক্ষে একটি লেগ থাকে।

legs প্রোপার্টিতে steps অ্যারেতে leg বরাবর প্রতিটি ধাপের সংজ্ঞা থাকে। বাকি প্রোপার্টি, যেমন distanceMeters , duration , এবং polyline leg সম্পর্কে তথ্য থাকে।

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}

ধাপের অ্যারে বুঝুন

প্রতিক্রিয়ার প্রতিটি লেগে একটি steps অ্যারে থাকে, যেখানে প্রতিটি steps অ্যারে উপাদান RouteLegStep ধরণের। একটি স্টেপ লেগ বরাবর একটি একক নির্দেশের সাথে মিলে যায়। একটি লেগে সর্বদা কমপক্ষে একটি স্টেপ থাকে।

steps অ্যারের প্রতিটি এলিমেন্টে navigationInstruction প্রোপার্টি থাকে, যা NavigationInstruction ধরণের, যাতে step instruction থাকে। উদাহরণস্বরূপ:

"navigationInstruction": {
  "maneuver": "TURN_LEFT",
  "instructions": "Turn left toward Frontage Rd"
}

instructions ধাপটি সম্পর্কে অতিরিক্ত তথ্য থাকতে পারে। উদাহরণস্বরূপ:

"navigationInstruction": {
  "maneuver": "TURN_SLIGHT_LEFT",
  "instructions": "Slight left (signs for I-90 W/Worcester)nParts of this road may be closed at certain times or days"
}

ধাপের বাকি বৈশিষ্ট্যগুলি ধাপ সম্পর্কে তথ্য বর্ণনা করে, যেমন distanceMeters , duration , এবং polyline :

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  }
}

ধাপ নির্দেশাবলীর ভাষা নির্দিষ্ট করুন।

API স্থানীয় ভাষায় রুট তথ্য ফেরত দেয়, যা ব্যবহারকারীর পছন্দের ভাষা পর্যবেক্ষণ করার সময় প্রয়োজনে পাঠযোগ্য স্ক্রিপ্টে প্রতিলিপিকৃত হয়। ঠিকানার উপাদানগুলি একই ভাষায় ফেরত দেওয়া হয়।

• সমর্থিত ভাষার তালিকা থেকে রুট ভাষা স্পষ্টভাবে সেট করতে একটি অনুরোধের languageCode প্যারামিটার ব্যবহার করুন। গুগল প্রায়শই সমর্থিত ভাষাগুলি আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।

• যদি নির্দিষ্ট ভাষায় কোনও নাম উপলব্ধ না হয়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে।

• নির্দিষ্ট ভাষা API দ্বারা নির্বাচিত ফলাফলের সেট এবং সেগুলি যে ক্রমে ফেরত পাঠানো হয় তা প্রভাবিত করতে পারে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলিকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার ধরণের সংক্ষিপ্ত রূপ, অথবা এমন সমার্থক শব্দ যা এক ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়। উদাহরণস্বরূপ, utca এবং tér হাঙ্গেরীয় ভাষায় রাস্তার সমার্থক শব্দ।

জিওকোডিং ফলাফল অ্যারে বুঝুন

অনুরোধের প্রতিটি অবস্থানের জন্য (উৎপত্তি, গন্তব্য, অথবা মধ্যবর্তী ওয়েপয়েন্ট) যা ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে নির্দিষ্ট করা হয়েছিল, API সবচেয়ে প্রাসঙ্গিক অবস্থানটি খুঁজে বের করার চেষ্টা করে যার একটি সংশ্লিষ্ট স্থান আইডি রয়েছে। geocodingResults অ্যারের প্রতিটি উপাদানে placeID ক্ষেত্র থাকে যেখানে স্থান আইডি হিসাবে অবস্থান থাকে এবং একটি type ক্ষেত্র থাকে যা অবস্থানের ধরণ নির্দিষ্ট করে, যেমন street_address , premise , অথবা airport ।

geocodingResults অ্যারেতে তিনটি ক্ষেত্র রয়েছে:

• origin : যদি এটি একটি ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে নির্দিষ্ট করা থাকে, তাহলে origin এর স্থান ID। অন্যথায়, এই ক্ষেত্রটি প্রতিক্রিয়া থেকে বাদ দেওয়া হবে।

• destination : যদি এটি একটি ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে নির্দিষ্ট করা থাকে, তাহলে গন্তব্যের স্থান আইডি। অন্যথায়, এই ক্ষেত্রটি প্রতিক্রিয়া থেকে বাদ দেওয়া হবে।

• intermediates : একটি অ্যারে যেখানে ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে নির্দিষ্ট করা যেকোনো ইন্টারমিডিয়েট ওয়েপয়েন্টের প্লেস আইডি থাকে। যদি আপনি একটি প্লেস আইডি বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে একটি ইন্টারমিডিয়েট ওয়েপয়েন্ট নির্দিষ্ট করেন, তাহলে এটি প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। অনুরোধে কোন ইন্টারমিডিয়েট ওয়েপয়েন্টটি প্রতিক্রিয়াতে স্থান আইডির সাথে মিলে যায় তা নির্ধারণ করতে প্রতিক্রিয়াতে intermediateWaypointRequestIndex বৈশিষ্ট্য ব্যবহার করুন।

"geocodingResults": {
    "origin": {
        "geocoderStatus": {},
        "type": [
             enum (Type)
        ],
        "placeId": string
    },
    "destination": {
        "geocoderStatus": {},
        "type": [
            enum (Type)
        ],
        "placeId": string
    },
    "intermediates": [
        {
            "geocoderStatus": {},
            "intermediateWaypointRequestIndex": integer,
            "type": [
                enum (Type)
            ],
            "placeId": string
        },
        {
           "geocoderStatus": {},
           "intermediateWaypointRequestIndex": integer,
            "type": [
                enum (Type)
            ],
            "placeId": string
        }
    ]
}

স্থানীয় প্রতিক্রিয়া মানগুলি বুঝুন

স্থানীয়কৃত প্রতিক্রিয়া মান হল একটি অতিরিক্ত প্রতিক্রিয়া ক্ষেত্র যা ফেরত দেওয়া প্যারামিটার মানের জন্য স্থানীয়কৃত পাঠ্য প্রদান করে। ভ্রমণের সময়কাল, দূরত্ব এবং ইউনিট সিস্টেম (মেট্রিক বা ইম্পেরিয়াল) এর জন্য স্থানীয়কৃত পাঠ্য প্রদান করা হয়। আপনি একটি ফিল্ড মাস্ক ব্যবহার করে স্থানীয়কৃত মানগুলির জন্য অনুরোধ করতে পারেন এবং ভাষা এবং ইউনিট সিস্টেম নির্দিষ্ট করতে পারেন অথবা API দ্বারা অনুমান করা মানগুলি ব্যবহার করতে পারেন। বিস্তারিত জানার জন্য, স্থানীয়কৃত মূল্য দেখুন।

উদাহরণস্বরূপ, যদি আপনি জার্মান (de) এবং ইম্পেরিয়াল ইউনিটের জন্য একটি ভাষা কোড নির্দিষ্ট করেন, তাহলে আপনি distanceMeters জন্য 49889.7 মান পাবেন, তবে স্থানীয় পাঠ্যটি জার্মান এবং ইম্পেরিয়াল ইউনিটে দূরত্ব পরিমাপ প্রদান করে, তাই "31 মেইল।"

স্থানীয় মানগুলির জন্য আপনি কী দেখতে পাবেন তার একটি উদাহরণ এখানে দেওয়া হল:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

যদি আপনি ভাষা বা ইউনিট সিস্টেম নির্দিষ্ট না করেন, তাহলে API ভাষা এবং ইউনিটগুলি নিম্নরূপ অনুমান করে:

• ComputeRoutes পদ্ধতিটি মূল ওয়েপয়েন্ট থেকে অবস্থান এবং দূরত্বের একক অনুমান করে। তাই মার্কিন যুক্তরাষ্ট্রে রাউটিং অনুরোধের জন্য, API en-US ভাষা এবং IMPERIAL ইউনিট অনুমান করে।
• ComputeRouteMatrix পদ্ধতিটি ডিফল্টভাবে 'en-US' ভাষা এবং METRIC ইউনিটে ব্যবহৃত হয়।