একটি পথ অতিক্রম করার জন্য একটি বিন্দু সেট করুন

ডিফল্টরূপে, মধ্যবর্তী ওয়েপয়েন্টগুলি পিকআপ এবং ড্রপঅফের জন্য থামার জন্য ব্যবহার করা হয়, তবে আপনি এটিও নির্দিষ্ট করতে পারেন যে একটি মধ্যবর্তী ওয়েপয়েন্ট কেবলমাত্র অতিক্রম করার জন্য।

একটি রুট যেটিতে একটি অরিজিন ওয়েপয়েন্ট, একটি পাস-থ্রু ইন্টারমিডিয়েট ওয়েপয়েন্ট এবং একটি গন্তব্য ওয়েপয়েন্টে শুধুমাত্র একটি রুট লেগ থাকে যা মূল এবং গন্তব্যকে সংযুক্ত করে, মধ্যবর্তী (যাকে একটি via বলা হয়) ওয়েপয়েন্ট দিয়ে যাওয়ার সময়।

ওয়েপয়েন্ট (REST) ​​বা ওয়েপয়েন্ট (gRPC) ব্যবহার করে ওয়েপয়েন্টের via সম্পত্তি true সেট করে একটি মধ্যবর্তী ওয়েপয়েন্টকে পাস-থ্রু ওয়েপয়েন্ট হতে কনফিগার করুন।

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

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি মধ্যবর্তী পথপয়েন্টকে পাস-থ্রু ওয়েপয়েন্ট হিসেবে চিহ্নিত করা যায়।

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

মধ্যবর্তী পথপয়েন্টের জন্য স্থান আইডি অ্যাক্সেস করুন

আপনি যদি ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে একটি উত্স, গন্তব্য, বা মধ্যবর্তী পথপয়েন্টের অবস্থান নির্দিষ্ট করেন, তাহলে API সবচেয়ে প্রাসঙ্গিক অবস্থান খুঁজে বের করার চেষ্টা করে যার একটি সংশ্লিষ্ট স্থান আইডি রয়েছে। ফলাফলের geocodingResults.intermediates অ্যারেতে অবস্থান সম্পর্কে অতিরিক্ত ডেটা সহ ওয়েপয়েন্টের অবস্থানের সাথে সংশ্লিষ্ট স্থান আইডি রয়েছে।

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

যেমন:

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

  • ফলাফলে geocodingResults অ্যারে ফেরত দেওয়ার জন্য আপনি প্রতিক্রিয়া ক্ষেত্রের মাস্কে geocodingResults অন্তর্ভুক্ত করেন।

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"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "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 অ্যারে অন্তর্ভুক্ত থাকে যেখানে মূল, গন্তব্য এবং তিনটি ওয়েপয়েন্টের মধ্যে দুটির জন্য স্থান আইডি রয়েছে। এগুলি অনুরোধের সূচক 0 এবং 2-এ ওয়েপয়েন্ট। যেহেতু অনুরোধের সূচী 1 এ ওয়েপয়েন্টটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে নির্দিষ্ট করা হয়েছিল, এটি প্রতিক্রিয়াতে geocodingResults অ্যারে থেকে বাদ দেওয়া হয়েছে।

{
  "routes": [{...}],
  "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"
      }
    ]
  }
}
,

ডিফল্টরূপে, মধ্যবর্তী ওয়েপয়েন্টগুলি পিকআপ এবং ড্রপঅফের জন্য থামার জন্য ব্যবহার করা হয়, তবে আপনি এটিও নির্দিষ্ট করতে পারেন যে একটি মধ্যবর্তী ওয়েপয়েন্ট কেবলমাত্র অতিক্রম করার জন্য।

একটি রুট যেটিতে একটি অরিজিন ওয়েপয়েন্ট, একটি পাস-থ্রু ইন্টারমিডিয়েট ওয়েপয়েন্ট এবং একটি গন্তব্য ওয়েপয়েন্টে শুধুমাত্র একটি রুট লেগ থাকে যা মূল এবং গন্তব্যকে সংযুক্ত করে, মধ্যবর্তী (যাকে একটি via বলা হয়) ওয়েপয়েন্ট দিয়ে যাওয়ার সময়।

ওয়েপয়েন্ট (REST) ​​বা ওয়েপয়েন্ট (gRPC) ব্যবহার করে ওয়েপয়েন্টের via সম্পত্তি true সেট করে একটি মধ্যবর্তী ওয়েপয়েন্টকে পাস-থ্রু ওয়েপয়েন্ট হতে কনফিগার করুন।

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

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি মধ্যবর্তী পথপয়েন্টকে পাস-থ্রু ওয়েপয়েন্ট হিসেবে চিহ্নিত করা যায়।

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

মধ্যবর্তী পথপয়েন্টের জন্য স্থান আইডি অ্যাক্সেস করুন

আপনি যদি ঠিকানা স্ট্রিং বা প্লাস কোড হিসাবে একটি উত্স, গন্তব্য, বা মধ্যবর্তী পথপয়েন্টের অবস্থান নির্দিষ্ট করেন, তাহলে API সবচেয়ে প্রাসঙ্গিক অবস্থান খুঁজে বের করার চেষ্টা করে যার একটি সংশ্লিষ্ট স্থান আইডি রয়েছে। ফলাফলের geocodingResults.intermediates অ্যারেতে অবস্থান সম্পর্কে অতিরিক্ত ডেটা সহ ওয়েপয়েন্টের অবস্থানের সাথে সংশ্লিষ্ট স্থান আইডি রয়েছে।

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

যেমন:

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

  • ফলাফলে geocodingResults অ্যারে ফেরত দেওয়ার জন্য আপনি প্রতিক্রিয়া ক্ষেত্রের মাস্কে geocodingResults অন্তর্ভুক্ত করেন।

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"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "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 অ্যারে অন্তর্ভুক্ত থাকে যেখানে মূল, গন্তব্য এবং তিনটি ওয়েপয়েন্টের মধ্যে দুটির জন্য স্থান আইডি রয়েছে। এগুলি অনুরোধের সূচক 0 এবং 2 এ ওয়েপয়েন্ট। যেহেতু অনুরোধের সূচী 1 এ ওয়েপয়েন্টটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে নির্দিষ্ট করা হয়েছিল, এটি প্রতিক্রিয়াতে geocodingResults অ্যারে থেকে বাদ দেওয়া হয়েছে।

{
  "routes": [{...}],
  "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"
      }
    ]
  }
}