একটি ট্রানজিট রুট পান

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

কিভাবে ট্রানজিট রুট অন্যান্য রুট থেকে পৃথক

ট্রানজিট রুট, যা আপনি TRANSIT-এর একটি ট্রাভেলমোড সেট করে অনুরোধ করেন, বিভিন্ন ট্রাভেলমোড বিকল্প ব্যবহার করে রুট থেকে আলাদা। আপনি একই অবজেক্ট এবং বিকল্পগুলির জন্য অনুরোধ করতে পারবেন না, এবং অন্যান্য রুটের তুলনায় প্রতিক্রিয়া বিভিন্ন ক্ষেত্র প্রদান করে।

Routes API-এ, ধাপগুলি সব ধরনের ভ্রমণের জন্য ধারাবাহিকভাবে একটি নেভিগেশন নির্দেশনা। তাই প্রতিটি নেভিগেশন নির্দেশ একটি ধাপ। একটি ট্রানজিট রুট প্রতিক্রিয়া অন্যান্য ভ্রমণ মোডগুলির সাথে রুটের সাথে খুব মিল, কয়েকটি মূল পার্থক্য সহ:

পার্থক্য অনুরোধ প্রতিক্রিয়া পার্থক্য
আপনি মধ্যবর্তী পথপয়েন্ট নির্দিষ্ট করতে পারবেন না। ট্রানজিট বিবরণ অন্তর্ভুক্ত.
পরিবেশ বান্ধব রুট পাওয়া যাচ্ছে না প্রতিটি ট্র্যাভেল মোডের জন্য মেটাডেটা অন্তর্ভুক্ত করে যাতে সেই ভ্রমণ মোডের ধাপগুলির সারাংশ থাকে, `স্টেপসওভারভিউ` (এই মেটাডেটা অনুরোধ করতে, `routes.legs.stepsOverview` ফিল্ড মাস্ক ব্যবহার করুন)।
কিভাবে এবং যদি ট্র্যাফিক ডেটা অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করতে পারে না৷
এড়ানোর জন্য রুট বৈশিষ্ট্য নির্দিষ্ট করা যাবে না
routingPreference জন্য শুধুমাত্র transitPreferences নির্দিষ্ট করতে পারে। বিস্তারিত জানার জন্য, [TransitPreferences](reference/rest/v2/TransitPreferences) দেখুন।

রুট এপিআই দ্বারা প্রত্যাবর্তিত প্রতিক্রিয়া সম্পর্কে আরও তথ্যের জন্য, ট্রানজিট রুটের প্রতিক্রিয়াগুলি পর্যালোচনা করুন।

একটি ট্রানজিট রুট পেতে

  1. আপনার উত্স এবং গন্তব্য সেট করুন.

  2. ট্রানজিটে ভ্রমণ মোড সেট করুন:

    travelMode: "TRANSIT"

  3. আপনি চান প্রতিক্রিয়া ক্ষেত্র পেতে একটি ফিল্ড মাস্ক যোগ করুন. আপনার প্রয়োজনীয় ট্রানজিট রুট ক্ষেত্রগুলির অনুরোধ দেখুন।

  4. প্রয়োজন হলে, ঐচ্ছিক পরামিতি সেট করুন। ট্রানজিট রুটের জন্য সেট প্যারামিটার দেখুন।

আপনার প্রয়োজন ট্রানজিট রুট ক্ষেত্র অনুরোধ

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

এই তথ্য অনুরোধ এই ফিল্ড মাস্ক ব্যবহার করুন
সমস্ত রুট বিবরণ routes.*
সমস্ত ট্রানজিট বিবরণ routes.legs.steps.transitDetails
প্রতিটি পায়ের জন্য অবস্থান শুরু করুন routes.legs.steps.startLocation
প্রতিটি পায়ের জন্য শেষ অবস্থান routes.legs.steps.endLocation
প্রতিটি ধাপের জন্য রুট পলিলাইন routes.legs.steps.polyline
প্রতিটি ধাপের জন্য ব্যবহৃত ট্রানজিটের প্রকার routes.legs.steps.travelMode
প্রতিটি ধাপ এবং রুটের জন্য আনুমানিক ভাড়া এবং স্থানীয়কৃত আনুমানিক ভাড়া routes.travel_advisory.transitFare localized routes.localizedValues.transitFare

দ্রষ্টব্য: transitFare শুধুমাত্র প্রদান করা হয় যদি API সমস্ত ধাপের জন্য ট্রানজিট ভাড়ার তথ্য নির্ধারণ করতে পারে।

সময়কাল এবং দূরত্বের জন্য স্থানীয় পাঠ্য routes.localizedValues

ফিল্ড মাস্ক সেট করা সম্পর্কে আরও তথ্যের জন্য, ফেরত দেওয়ার জন্য ক্ষেত্র চয়ন করুন দেখুন।

ট্রানজিট রুটের জন্য প্যারামিটার সেট করুন

এখানে ট্রানজিট রুটের জন্য প্রাসঙ্গিক পরামিতি রয়েছে:

এটা করতে এই প্যারামিটার ব্যবহার করুন মন্তব্য
ট্রানজিট মোড নির্বাচন করুন travelMode: "TRANSIT" প্রয়োজন। আরও জানুন
একটি আগমন বা প্রস্থান সময় সেট করুন "arrivalTime": "yyyy-mm-ddThh:mm:ssZ"

বা

"departureTime": "yyyy-mm-ddThh:mm:ssZ"
ঐচ্ছিক। আপনি arrival_time বা departure_time হয় উল্লেখ করতে পারেন। যদি কোনো সময় নির্দিষ্ট করা না থাকে, তাহলে departure_time বর্তমান এক্সিকিউশন টাইম ( now ) থেকে ডিফল্ট হয়। আপনি শুধুমাত্র নিম্নলিখিত সময় উইন্ডোর মধ্যে আগমন এবং প্রস্থানের সময় নির্ধারণ করতে পারেন, বর্তমান নির্বাহের সময় ( now ) রেফারেন্স হিসাবে:
  • now থেকে 7 দিন আগে পর্যন্ত এবং সহ
  • now থেকে 100 দিন পর পর্যন্ত এবং সহ
সময়কে RFC3339 UTC "জুলু" ফর্ম্যাটে টাইমস্ট্যাম্প হিসাবে প্রকাশ করা হয়। আরও জানুন
বিকল্প রুট অন্তর্ভুক্ত করুন "computeAlternativeRoutes": true ঐচ্ছিক। উপলভ্য হলে 3টি অতিরিক্ত রুট পর্যন্ত রুট API গণনা করার জন্য সত্যে সেট করুন। আরও জানুন
ট্রানজিট প্রকারের জন্য পছন্দগুলি নির্দিষ্ট করুন৷ "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}

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

ঐচ্ছিক। পছন্দের ট্রানজিট ভ্রমণ মোড নির্দিষ্ট করুন। আরও জানুন
ট্রানজিট রুটের জন্য পছন্দগুলি উল্লেখ করুন "transitPreferences": {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} ঐচ্ছিক। ট্রানজিট রাউটিং পছন্দগুলি নির্দিষ্ট করুন৷ আরও জানুন

উদাহরণ: ট্রানজিটে একটি রুট পান

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

  • একটি ট্রেনে ভ্রমণ এবং কম হাঁটার জন্য পছন্দগুলি নির্দিষ্ট করে৷

  • বিকল্প রুটের অনুরোধ।

  • একটি ফিল্ড মাস্ক প্রদান করে যা ট্রানজিটের বিবরণ প্রদান করে:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "address": "Humberto Delgado Airport, Portugal"
  },
  "destination": {
    "address": "Basílica of Estrela, Praça da Estrela, 1200-667 Lisboa, Portugal"
  },
  "travelMode": "TRANSIT",
  "computeAlternativeRoutes": true,
  "transitPreferences": {
     routingPreference: "LESS_WALKING",
     allowedTravelModes: ["TRAIN"]
  },
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.legs.steps.transitDetails' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

প্রতিক্রিয়া দুটি রুটের জন্য route.legs.steps.transitDetails ক্ষেত্র দেখায়:

{
  "routes": [
    {
    "legs": [
        {
        "steps": [
          {},
          {},
          {},
          {
          "transitDetails": {
            "stopDetails": {
            "arrivalStop": {
              "name": "Saldanha",
              "location": {
                "latLng": {
                  "latitude": 38.73532,
                  "longitude": -9.14543
                }
              }
            },
            "arrivalTime": "2023-08-26T10:49:42Z",
            "departureStop": {
              "name": "Aeroporto",
              "location": {
                "latLng": {
                  "latitude": 38.769047799999996,
                  "longitude": -9.1284593
                }
              }
            },
            "departureTime": "2023-08-26T10:32:10Z"
              },
              "localizedValues": {
              "arrivalTime": {
                  "time": {
                    "text": "11:49"
                  },
                  "timeZone": "Europe/Lisbon"
              },
              "departureTime": {
                "time": {
                  "text": "11:32"
                },
                "timeZone": "Europe/Lisbon"
              }
            },
              "headsign": "São Sebastião",
              "transitLine": {
                "agencies": [
                  {
                    "name": "Metropolitano de Lisboa, E.P.E.",
                    "phoneNumber": "+351 21 350 0115",
                    "uri": "https://www.metrolisboa.pt/"
                  }
                ],
                "name": "Vermelha",
                "color": "#f23061",
                "nameShort": "Vm",
                "textColor": "#000000",
                "vehicle": {
                  "name": {
                    "text": "Metrô"
                  },
                "type": "SUBWAY",
                "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png"
                }
              },
              "stopCount": 11
            }
          },
        {},
        {
          "transitDetails": {
            "stopDetails": {
              "arrivalStop": {
                "name": "Rato",
                "location": {
                  "latLng": {
                    "latitude": 38.7201022,
                    "longitude": -9.1540562
                  }
              }
            },
            "arrivalTime": "2023-08-26T11:01:37Z",
            "departureStop": {
              "name": "Saldanha",
                "location": {
                  "latLng": {
                    "latitude": 38.73527,
                    "longitude": -9.1455200000000012
                  }
                }
              },
              "departureTime": "2023-08-26T10:57:57Z"
            },
            "localizedValues": {
              "arrivalTime": {
                "time": {
                  "text": "12:01"
                },
                "timeZone": "Europe/Lisbon"
              },
              "departureTime": {
                "time": {
                  "text": "11:57"
                },
                "timeZone": "Europe/Lisbon"
              }
            },
            "headsign": "Rato",
            "transitLine": {
              "agencies": [
                {
                "name": "Metropolitano de Lisboa, E.P.E.",
                "phoneNumber": "+351 21 350 0115",
                "uri": "https://www.metrolisboa.pt/"
                }
              ],
              "name": "Amarela",
              "color": "#f2c200",
              "nameShort": "Am",
              "textColor": "#000000",
              "vehicle": {
                "name": {
                  "text": "Metrô"
                },
                "type": "SUBWAY",
                "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png"
              }
            },
            "stopCount": 4
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}