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

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

अगर आपको क्रम से मिले जीपीएस पॉइंट के साथ काम करना है, तो Snap to Roads का इस्तेमाल करें.

अनुरोध

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

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 से मिलने वाले सभी placeId, सड़क के सेगमेंट से जुड़े होते हैं.

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

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

LatitudeLongitudeLiteral

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

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

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

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