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

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

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

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

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

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

ক্ষেত্রের মুখোশ সম্পর্কে

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

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

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

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

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

Powered by Google, © YEAR Google

যেমন:

Powered by Google, ©2023 Google

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

রুট এপিআই দ্বারা প্রত্যাবর্তিত প্রতিক্রিয়া দেখার আগে, আপনার একটি রুট তৈরির উপাদানগুলি সম্পর্কে বোঝা উচিত:

পথ, পা, এবং ধাপ।

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

  • রুট : মূল ওয়েপয়েন্ট থেকে পুরো ট্রিপ, যেকোনো মধ্যবর্তী ওয়েপয়েন্টের মাধ্যমে, গন্তব্য ওয়েপয়েন্ট পর্যন্ত। একটি রুট এক বা একাধিক পা নিয়ে গঠিত।

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

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

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

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

প্রতিক্রিয়া কি আছে

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

  • routes , রুট টাইপের উপাদানগুলির একটি অ্যারে। routes অ্যারেতে API দ্বারা প্রত্যাবর্তিত প্রতিটি রুটের জন্য একটি উপাদান রয়েছে। অ্যারেতে সর্বাধিক পাঁচটি উপাদান থাকতে পারে: ডিফল্ট রুট, ইকো-ফ্রেন্ডলি রুট এবং তিনটি বিকল্প রুট পর্যন্ত।

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

  • 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 অ্যারে সম্পত্তির সাথে চিহ্নিত করা হয়:

মান বর্ণনা
DEFAULT_ROUTE ডিফল্ট রুট সনাক্ত করে।
FUEL_EFFICIENT পরিবেশ বান্ধব রুট চিহ্নিত করে।
DEFAULT_ROUTE_ALTERNATE আমি একটি বিকল্প পথ নির্দেশ করি।

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 অ্যারেতে পা বরাবর প্রতিটি ধাপের সংজ্ঞা রয়েছে। অবশিষ্ট বৈশিষ্ট্য, যেমন distanceMeters , duration এবং polyline পা সম্পর্কে তথ্য রয়েছে।

{
  "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 প্রকারের, যাতে ধাপের নির্দেশ রয়েছে। যেমন:

"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 প্যারামিটার ব্যবহার করুন। Google প্রায়ই সমর্থিত ভাষা আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।

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

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

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

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

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

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

  • 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 দ্বারা অনুমান করা মানগুলি ব্যবহার করতে পারেন৷ বিস্তারিত জানার জন্য, স্থানীয়কৃত মান দেখুন।

উদাহরণস্বরূপ, যদি আপনি জার্মান (ডি) এবং ইম্পেরিয়াল ইউনিটগুলির জন্য একটি ভাষা কোড নির্দিষ্ট করেন, তাহলে আপনি 49889.7 এর distanceMeters জন্য একটি মান পাবেন, তবে জার্মান এবং ইম্পেরিয়াল ইউনিটগুলিতে সেই দূরত্ব পরিমাপ প্রদানকারী স্থানীয় পাঠ্যও পাবেন, তাই "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 ইউনিটে।
,

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

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

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

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

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

ক্ষেত্রের মুখোশ সম্পর্কে

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

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

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

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

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

Powered by Google, © YEAR Google

যেমন:

Powered by Google, ©2023 Google

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

রুট এপিআই দ্বারা প্রত্যাবর্তিত প্রতিক্রিয়া দেখার আগে, আপনার একটি রুট তৈরির উপাদানগুলি সম্পর্কে বোঝা উচিত:

পথ, পা, এবং ধাপ।

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

  • রুট : মূল ওয়েপয়েন্ট থেকে পুরো ট্রিপ, যেকোনো মধ্যবর্তী ওয়েপয়েন্টের মাধ্যমে, গন্তব্য ওয়েপয়েন্ট পর্যন্ত। একটি রুট এক বা একাধিক পা নিয়ে গঠিত।

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

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

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

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

প্রতিক্রিয়া কি আছে

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

  • routes , রুট টাইপের উপাদানগুলির একটি অ্যারে। routes অ্যারেতে API দ্বারা প্রত্যাবর্তিত প্রতিটি রুটের জন্য একটি উপাদান রয়েছে। অ্যারেতে সর্বাধিক পাঁচটি উপাদান থাকতে পারে: ডিফল্ট রুট, ইকো-ফ্রেন্ডলি রুট এবং তিনটি বিকল্প রুট পর্যন্ত।

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

  • 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 অ্যারে সম্পত্তির সাথে চিহ্নিত করা হয়:

মান বর্ণনা
DEFAULT_ROUTE ডিফল্ট রুট সনাক্ত করে।
FUEL_EFFICIENT পরিবেশ বান্ধব রুট চিহ্নিত করে।
DEFAULT_ROUTE_ALTERNATE আমি একটি বিকল্প পথ নির্দেশ করি।

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 অ্যারেতে পা বরাবর প্রতিটি ধাপের সংজ্ঞা রয়েছে। অবশিষ্ট বৈশিষ্ট্য, যেমন distanceMeters , duration এবং polyline পা সম্পর্কে তথ্য রয়েছে।

{
  "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 প্রকারের, যাতে ধাপের নির্দেশ রয়েছে। যেমন:

"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 প্যারামিটার ব্যবহার করুন। Google প্রায়ই সমর্থিত ভাষা আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।

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

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

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

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

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

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

  • 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 দ্বারা অনুমান করা মানগুলি ব্যবহার করতে পারেন৷ বিস্তারিত জানার জন্য, স্থানীয়কৃত মান দেখুন।

উদাহরণস্বরূপ, যদি আপনি জার্মান (ডি) এবং ইম্পেরিয়াল ইউনিটগুলির জন্য একটি ভাষা কোড নির্দিষ্ট করেন, তাহলে আপনি 49889.7 এর distanceMeters জন্য একটি মান পাবেন, তবে জার্মান এবং ইম্পেরিয়াল ইউনিটগুলিতে সেই দূরত্ব পরিমাপ প্রদানকারী স্থানীয় পাঠ্যও পাবেন, তাই "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 ইউনিটে।
,

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

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

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

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

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

ক্ষেত্রের মুখোশ সম্পর্কে

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

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

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

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

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

Powered by Google, © YEAR Google

যেমন:

Powered by Google, ©2023 Google

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

রুট এপিআই দ্বারা প্রত্যাবর্তিত প্রতিক্রিয়া দেখার আগে, আপনার একটি রুট তৈরির উপাদানগুলি সম্পর্কে বোঝা উচিত:

পথ, পা, এবং ধাপ।

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

  • রুট : মূল ওয়েপয়েন্ট থেকে পুরো ট্রিপ, যেকোনো মধ্যবর্তী ওয়েপয়েন্টের মাধ্যমে, গন্তব্য ওয়েপয়েন্ট পর্যন্ত। একটি রুট এক বা একাধিক পা নিয়ে গঠিত।

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

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

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

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

প্রতিক্রিয়া কি আছে

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

  • routes , রুট টাইপের উপাদানগুলির একটি অ্যারে। routes অ্যারেতে API দ্বারা প্রত্যাবর্তিত প্রতিটি রুটের জন্য একটি উপাদান রয়েছে। অ্যারেতে সর্বাধিক পাঁচটি উপাদান থাকতে পারে: ডিফল্ট রুট, ইকো-ফ্রেন্ডলি রুট এবং তিনটি বিকল্প রুট পর্যন্ত।

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

  • 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 অ্যারে সম্পত্তির সাথে চিহ্নিত করা হয়:

মান বর্ণনা
DEFAULT_ROUTE ডিফল্ট রুট সনাক্ত করে।
FUEL_EFFICIENT পরিবেশ বান্ধব রুট চিহ্নিত করে।
DEFAULT_ROUTE_ALTERNATE আমি একটি বিকল্প পথ নির্দেশ করি।

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 অ্যারেতে পা বরাবর প্রতিটি ধাপের সংজ্ঞা রয়েছে। অবশিষ্ট বৈশিষ্ট্য, যেমন distanceMeters , duration এবং polyline পা সম্পর্কে তথ্য রয়েছে।

{
  "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 প্রকারের, যাতে ধাপের নির্দেশ রয়েছে। যেমন:

"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 প্যারামিটার ব্যবহার করুন। Google প্রায়ই সমর্থিত ভাষা আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।

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

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

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

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

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

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

  • 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
        }
    ]
}

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

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

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

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

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

আপনি যদি ভাষা বা ইউনিট সিস্টেমটি নির্দিষ্ট না করেন তবে এপিআই নিম্নলিখিত ভাষা এবং ইউনিটগুলিকে প্ররোচিত করে:

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

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

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

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

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

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

মাঠের মুখোশ সম্পর্কে

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

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

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

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

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

Powered by Google, © YEAR Google

যেমন:

Powered by Google, ©2023 Google

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

রুট এপিআই দ্বারা ফিরে আসা প্রতিক্রিয়া দেখার আগে আপনার উপাদানগুলির একটি বোঝা উচিত যা কোনও রুট তৈরি করে:

রুট, পা এবং পদক্ষেপ।

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

  • রুট : যে কোনও মধ্যবর্তী পথের মাধ্যমে, গন্তব্য ওয়েপপয়েন্টে মূল ভ্রমণ থেকে পুরো ট্রিপ। একটি রুটে এক বা একাধিক পা থাকে।

  • লেগ : রুটের পরবর্তী পথের পথের একটি পথ থেকে পথ থেকে পথ। প্রতিটি পা এক বা একাধিক পৃথক পদক্ষেপ নিয়ে গঠিত।

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

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

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

প্রতিক্রিয়া কি আছে

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

  • routes , টাইপ রুটের উপাদানগুলির একটি অ্যারে। routes অ্যারেতে এপিআই দ্বারা ফিরে আসা প্রতিটি রুটের জন্য একটি উপাদান রয়েছে। অ্যারেতে সর্বোচ্চ পাঁচটি উপাদান থাকতে পারে: ডিফল্ট রুট, পরিবেশ বান্ধব রুট এবং তিনটি বিকল্প রুট পর্যন্ত।

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

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

প্রতিক্রিয়া ফর্ম আছে:

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

রুটগুলি অ্যারেটি ডেসিফার করুন

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

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

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

মান বর্ণনা
DEFAULT_ROUTE ডিফল্ট রুট সনাক্ত করে।
FUEL_EFFICIENT পরিবেশ বান্ধব রুট সনাক্ত করে।
DEFAULT_ROUTE_ALTERNATE আমি একটি বিকল্প রুটকে ndicates।

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 অ্যারে উপাদানটি টাইপ রুটলেগের থাকে। অ্যারের প্রতিটি পা রুট বরাবর একটি ওয়ে পয়েন্ট থেকে পরবর্তী ওয়েপপয়েন্টে পথটি সংজ্ঞায়িত করে। একটি রুটে সর্বদা কমপক্ষে একটি পা থাকে।

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

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

পদক্ষেপ অ্যারে বুঝতে

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

অ্যারে steps প্রতিটি উপাদানের মধ্যে navigationInstruction সম্পত্তি, টাইপ নেভিগেশন ইনস্ট্রাকশন অন্তর্ভুক্ত রয়েছে, এতে পদক্ষেপের নির্দেশনা রয়েছে। যেমন:

"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)
  }
}

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

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

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

  • যদি নির্দিষ্ট ভাষায় কোনও নাম উপলব্ধ না হয় তবে এপিআই নিকটতম ম্যাচটি ব্যবহার করে।

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

জিওকোডিং রিসাল্টস অ্যারে বুঝতে

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

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

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

  • 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
        }
    ]
}

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

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

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

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

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

আপনি যদি ভাষা বা ইউনিট সিস্টেমটি নির্দিষ্ট না করেন তবে এপিআই নিম্নলিখিত ভাষা এবং ইউনিটগুলিকে প্ররোচিত করে:

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