কোনও রুট যে পয়েন্টের মধ্যে দিয়ে যাবে সেটি সেট করা

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

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

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

একটি রুটে উৎস, এক বা একাধিক পাস-থ্রু ইন্টারমিডিয়েট ওয়েপয়েন্ট এবং গন্তব্য থাকলে, সেটিতে শুধু একটি রুট লেগ থাকে যা উৎসকে সরাসরি গন্তব্যের সাথে কানেক্ট করে।

কোনও মধ্যবর্তী ওয়েপয়েন্টকে পাস-থ্রু ওয়েপয়েন্ট হিসেবে কনফিগার করতে, REST Waypoint রিসোর্স অথবা gRPC Waypoint মেসেজে ওয়েপয়েন্টের via প্রপার্টি true-এ সেট করুন।

Routes API ঠিকানা, স্থান আইডি এবং অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক গ্রহণ করলেও, অক্ষাংশ ও দ্রাঘিমাংশ, অথবা latLng, স্থানাঙ্ক পাস-থ্রু ওয়েপয়েন্টের জন্য সবচেয়ে সুনির্দিষ্ট রুট অ্যাডজাস্টমেন্ট প্রদান করে।

ম্যাপে ওয়েপয়েন্ট টেনে আনার উত্তরে আপনি রুট তৈরি করলে, via প্রপার্টি সবচেয়ে কার্যকর হয়। এই পদ্ধতি আপনাকে রিয়েল টাইমে চূড়ান্ত রুট কেমন দেখতে তা দেখতে দেয় এবং অ্যাক্সেসযোগ্য লোকেশনে ওয়েপয়েন্ট রাখতে সাহায্য করে।

উদাহরণ: পাস-থ্রু ওয়েপয়েন্ট সেট করা

সম্পূর্ণ computeRoutes পোস্ট অনুরোধে মধ্যবর্তী ওয়েপয়েন্টে কীভাবে "via": true সেট করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "via": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

পাস-থ্রু ওয়েপয়েন্টের জন্য ঠিকানা বা স্থান আইডি ব্যবহার করা

আমরা সঠিক পাস-থ্রু রাউটিংয়ের জন্য অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক সাজেস্ট করলেও, আপনি ঠিকানা স্ট্রিং বা স্থান আইডি ব্যবহার করে মধ্যবর্তী ওয়েপয়েন্ট নির্দিষ্ট করতে পারেন।

আপনি যখন পাস-থ্রু ওয়েপয়েন্টের জন্য একটি ঠিকানা বা স্থান আইডি ব্যবহার করেন, তখন API ইন্টারপোলেট করে এবং লোকেশনটিকে সবচেয়ে কাছের নেভিগেবল রাস্তায় স্ন্যাপ করে। এই রোড-স্ন্যাপিং প্রসেসের ফলে কখনও কখনও সঠিক স্থানাঙ্কের তুলনায় রুটে পরিবর্তন বা ভুল হতে পারে।

আপনি যদি অ্যাড্রেস স্ট্রিং বা Plus Code ব্যবহার করে কোনও ওয়েপয়েন্ট নির্দিষ্ট করেন, তাহলে API লোকেশন জিওকোড করে এবং রেসপন্সে geocodingResults.intermediates অ্যারেতে ম্যাচিং প্লেস আইডি ফিরিয়ে দেয়।

intermediates অ্যারের প্রতিটি এলিমেন্টের জন্য, intermediateWaypointRequestIndex প্রপার্টি ব্যবহার করে নির্ধারণ করুন যে অনুরোধের কোন মধ্যবর্তী ওয়েপয়েন্ট উত্তরের প্লেস আইডির সাথে সম্পর্কিত।

উদাহরণ: পাস-থ্রু ওয়েপয়েন্টের জন্য জায়গার আইডি অনুরোধ করা

নিম্নলিখিত উদাহরণে তিনটি পাস-থ্রু ইন্টারমিডিয়েট ওয়েপয়েন্ট সহ একটি অনুরোধ দেখানো হয়েছে, যার প্রত্যেকটি "via": true নির্দিষ্ট করে:

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA",
      "via": true
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "via": true
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063",
      "via": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

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

{
  "routes": [
    {
      "distanceMeters": 54200,
      "duration": "2400s",
      "legs": [
        {
          "distanceMeters": 54200,
          "duration": "2400s",
          "startLocation": {
            "latLng": {
              "latitude": 37.4220,
              "longitude": -122.0841
            }
          },
          "endLocation": {
            "latLng": {
              "latitude": 37.7786,
              "longitude": -122.3893
            }
          }
        }
      ]
    }
  ],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
          "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}