सबसे नज़दीकी सड़कें

Roads API में 100 अलग-अलग निर्देशांकों का इस्तेमाल किया जा सकता है. यह हर पॉइंट के लिए, सबसे नज़दीकी सड़क सेगमेंट की जानकारी देता है. यह ज़रूरी नहीं है कि पास किए गए पॉइंट, एक ही पाथ का हिस्सा हों.

अगर आपको क्रम से जीपीएस पॉइंट का इस्तेमाल करना है, तो सड़क पर स्नैप करें सुविधा का इस्तेमाल करें.

अनुरोध

आस-पास की सड़कों के लिए अनुरोध, एचटीटीपीएस का इस्तेमाल करके भेजा जाना चाहिए. इसका फ़ॉर्मैट यह है:

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

ज़रूरी पैरामीटर

  • अंक

    स्नैप किए जाने वाले पॉइंट. पॉइंट पैरामीटर, अक्षांश/देशांतर के जोड़े की सूची स्वीकार करता है. अक्षांश और देशांतर की वैल्यू को कॉमा लगाकर अलग करें. निर्देशांकों को पाइप वर्ण: "|" से अलग करें. उदाहरण के लिए: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

उदाहरण

यहां दिए गए अनुरोध में, निर्देशांकों की दी गई सूची के आधार पर सड़क के सेगमेंट का एक सेट दिखाया गया है.

URL

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

curl

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

जवाब में इस स्कीमा का इस्तेमाल किया गया है.

NearestRoadsResponse

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं Array<SnappedPoint>

स्नैप किए गए पॉइंट का कलेक्शन. कभी-कभी, इसमें एक ही पॉइंट के लिए कई स्नैप किए गए पॉइंट होते हैं. हालांकि, इनके placeId या जगह की जानकारी अलग-अलग होती है.

ज़्यादा जानकारी के लिए, SnappedPoint देखें.

SnappedPoint

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है LatitudeLongitudeLiteral ज़्यादा जानकारी के लिए, LatitudeLongitudeLiteral देखें.
ज़रूरी है स्ट्रिंग

किसी जगह के लिए यूनीक आइडेंटिफ़ायर. Roads API से मिले सभी प्लेस आईडी, सड़क के सेगमेंट से जुड़े होते हैं.

ज़रूरी नहीं संख्या

यह एक पूर्णांक होता है. इससे ओरिजनल अनुरोध में मौजूद वैल्यू का पता चलता है. अनुरोध में मौजूद हर वैल्यू को, जवाब में मौजूद स्नैप की गई वैल्यू पर मैप किया जाना चाहिए. हालांकि, अगर आपने interpolate=true सेट किया है या आस-पास की सड़कों का इस्तेमाल किया जा रहा है, तो ऐसा हो सकता है कि जवाब में अनुरोध से ज़्यादा कोऑर्डिनेट शामिल हों. इंटरपोलेट की गई वैल्यू में originalIndex नहीं होगा. इन वैल्यू को 0 से इंडेक्स किया जाता है. इसलिए, 4 के originalIndex वाला पॉइंट, पाथ पैरामीटर को पास किए गए पांचवें अक्षांश/देशांतर की स्नैप की गई वैल्यू होगा. सबसे नज़दीकी सड़कों के पॉइंट में, एक ही कोऑर्डिनेट के लिए कई पॉइंट हो सकते हैं. हालांकि, इनकी जगह या placeId अलग-अलग हो सकते हैं.

LatitudeLongitudeLiteral

यह एक ऑब्जेक्ट है. इसमें किसी जगह के अक्षांश और देशांतर की जानकारी दशमलव डिग्री में दी जाती है.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

दशमलव डिग्री में अक्षांश
ज़रूरी है संख्या

दशमलव डिग्री में देशांतर