কাছের রাস্তা

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

আপনি যদি ধারাবাহিক জিপিএস পয়েন্ট নিয়ে কাজ করেন, তাহলে Snap to Roads ব্যবহার করুন।

অনুরোধ

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

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

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

  • পয়েন্ট

    যে পয়েন্টগুলো স্ন্যাপ করতে হবে। 'points' প্যারামিটারটি অক্ষাংশ/দ্রাঘিমাংশের জোড়ার একটি তালিকা গ্রহণ করে। অক্ষাংশ এবং দ্রাঘিমাংশের মান কমা দিয়ে আলাদা করুন। স্থানাঙ্কগুলো পাইপ ক্যারেক্টার "|" দিয়ে আলাদা করুন। উদাহরণস্বরূপ: 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 অনুরোধ ইউআরএল-এ নির্দেশিত বিন্যাসে একটি প্রতিক্রিয়া ফেরত দেবে।

{
  "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",
      },
    ],
}

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

নিকটতম সড়ক প্রতিক্রিয়া

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
ঐচ্ছিক অ্যারে< স্ন্যাপডপয়েন্ট >

স্ন্যাপ করা পয়েন্টগুলোর একটি অ্যারে। কখনও কখনও এতে একই পয়েন্টের জন্য ভিন্ন placeId বা location সহ একাধিক স্ন্যাপ করা পয়েন্ট থাকতে পারে।

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

স্ন্যাপডপয়েন্ট

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
প্রয়োজনীয় অক্ষাংশ দ্রাঘিমাংশ আক্ষরিক আরও তথ্যের জন্য LatitudeLongitudeLiteral দেখুন।
প্রয়োজনীয় স্ট্রিং

কোনো স্থানের জন্য একটি অনন্য শনাক্তকারী। Roads API দ্বারা ফেরত দেওয়া সমস্ত স্থান আইডি সড়ক অংশের সাথে সঙ্গতিপূর্ণ।

ঐচ্ছিক সংখ্যা

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

অক্ষাংশ দ্রাঘিমাংশ আক্ষরিক

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

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
প্রয়োজনীয় সংখ্যা

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

প্রয়োজনীয় সংখ্যা

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