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

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

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

অন্যান্য রুট থেকে ট্রানজিট রুট কীভাবে আলাদা

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

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

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

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

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

  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 থেকে ৭ দিন আগে পর্যন্ত এবং এর মধ্যে অন্তর্ভুক্ত
  • now থেকে ১০০ দিন পর্যন্ত এবং এর মধ্যে অন্তর্ভুক্ত
সময়কে RFC3339 UTC "জুলু" ফর্ম্যাটে টাইমস্ট্যাম্প হিসেবে প্রকাশ করা হয়। আরও জানুন

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

বিকল্প রুট অন্তর্ভুক্ত করুন "computeAlternativeRoutes": true ঐচ্ছিক। কম্পিউট রুটগুলি যখন উপলব্ধ থাকে তখন অতিরিক্ত 3 টি রুট গণনা করতে সত্যে সেট করুন। আরও জানুন
ট্রানজিট ধরণের জন্য পছন্দগুলি নির্দিষ্ট করুন "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
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}