নিকটবর্তী রাস্তা

Roads API সর্বাধিক ১০০টি স্বতন্ত্র স্থানাঙ্ক নেয় এবং প্রতিটি পয়েন্টের জন্য সবচেয়ে কাছের রাস্তার অংশ দেখায়। পাস করা পয়েন্টগুলি কোনও অবিচ্ছিন্ন পাথের অংশ হতে হবে না।

আপনি যদি ক্রমিক জিপিএস পয়েন্ট নিয়ে কাজ করেন, তাহলে স্ন্যাপ টু রোড ব্যবহার করুন।

অনুরোধ

HTTPS ব্যবহার করে নিকটতম রাস্তার জন্য অনুরোধ পাঠাতে হবে এবং এটি নিম্নলিখিত ফর্ম গ্রহণ করে:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

প্রয়োজনীয় প্যারামিটার

পয়েন্ট

স্ন্যাপ করার জন্য পয়েন্ট। পয়েন্ট প্যারামিটার অক্ষাংশ/দ্রাঘিমাংশ জোড়ার তালিকা গ্রহণ করে। অক্ষাংশ ও দ্রাঘিমাংশের মান কমা দিয়ে আলাদা করুন। পাইপ অক্ষর দিয়ে স্থানাঙ্ক আলাদা করুন: "|"। যেমন: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796।

উদাহরণ

নিম্নলিখিত অনুরোধটি স্থানাঙ্কের নির্দিষ্ট তালিকার উপর ভিত্তি করে রাস্তার সেগমেন্টের একটি সেট ফেরত দেয়।

ইউআরএল

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

প্রতিক্রিয়া

প্রতিটি সঠিক অনুরোধের জন্য, Roads API অনুরোধের URL-এ উল্লেখ করা ফর্ম্যাটে উত্তর দেবে।

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

উত্তরে নিম্নলিখিত স্কিমা ব্যবহার করা হয়েছে।

NearestRoadsResponse

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
ঐচ্ছিক Array<SnappedPoint>

স্ন্যাপ করা পয়েন্টের অ্যারে। কখনও কখনও একই পয়েন্টের জন্য আলাদা আলাদা placeId বা লোকেশন সহ একাধিক স্ন্যাপ করা পয়েন্ট থাকে।

আরও তথ্যের জন্য SnappedPoint দেখুন।

SnappedPoint

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় LatitudeLongitudeLiteral আরও তথ্যের জন্য LatitudeLongitudeLiteral দেখুন।
প্রয়োজনীয় স্ট্রিং

কোনও জায়গার জন্য অনন্য শনাক্তকারী। Roads API-এর মাধ্যমে ফেরত পাঠানো সব জায়গার আইডি রাস্তার সেগমেন্টের সাথে সম্পর্কিত।

ঐচ্ছিক নম্বর

একটি পূর্ণসংখ্যা যা আসল অনুরোধে সংশ্লিষ্ট মান নির্দেশ করে। অনুরোধের প্রতিটি ভ্যালু উত্তরের স্ন্যাপ করা ভ্যালুর সাথে ম্যাপ করা উচিত। তবে, আপনি interpolate=true সেট করে থাকলে অথবা নিকটবর্তী রাস্তা ব্যবহার করলে, সেক্ষেত্রে অনুরোধের তুলনায় উত্তরে আরও বেশি স্থানাঙ্ক থাকতে পারে। ইন্টারপোলেট করা ভ্যালুতে originalIndex থাকবে না। এইসব ভ্যালু 0 থেকে ইনডেক্স করা হয়, তাই 4-এর originalIndex সহ একটি পয়েন্ট, পাথ প্যারামিটারে পাস করা ৫ম অক্ষাংশ/দ্রাঘিমাংশের স্ন্যাপ করা ভ্যালু হবে। Nearest Roads পয়েন্টে আলাদা লোকেশন বা placeId সহ একক কোঅর্ডিনেটের জন্য একাধিক পয়েন্ট থাকতে পারে।

LatitudeLongitudeLiteral

দশমিক ডিগ্রিতে অক্ষাংশ এবং দ্রাঘিমাংশ সহ একটি নির্দিষ্ট লোকেশন বর্ণনা করে এমন একটি অবজেক্ট।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় নম্বর

দশমিক ডিগ্রিতে অক্ষাংশ
প্রয়োজনীয় নম্বর

দশমিক ডিগ্রিতে দ্রাঘিমাংশ