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

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 সহ একটি পয়েন্ট, পাথ প্যারামিটারে পাস করা ৫ম অক্ষাংশ/দ্রাঘিমাংশের স্ন্যাপ করা ভ্যালু হবে। নিকটতম রাস্তা পয়েন্টে একই কোঅর্ডিনেটের জন্য একাধিক পয়েন্ট থাকতে পারে যেগুলির লোকেশন বা placeId আলাদা।

LatitudeLongitudeLiteral

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

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

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

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