गति की सीमाएं

Roads API, दिए गए सड़क के सेगमेंट के लिए पोस्ट की गई रफ़्तार की सीमा दिखाता है. गति सीमाओं में बदलाव होने पर सड़क के सेगमेंट के मामले में, सेगमेंट के लिए डिफ़ॉल्ट रफ़्तार की सीमा दिखती है.

रफ़्तार की सीमा के बारे में Roads API से मिले डेटा के सटीक होने की गारंटी नहीं दी जा सकती. रफ़्तार की सीमा से जुड़ा डेटा रीयल-टाइम में नहीं दिया जाता. यह अनुमानित, गलत, अधूरा, और/या पुराना हो सकता है. उन इलाकों के बारे में जानने के लिए कवरेज की जानकारी देखें जहां स्पीड लिमिट का डेटा उपलब्ध है.

अनुरोध

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

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

पैरामीटर का इस्तेमाल

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

• path या placeId पैरामीटर.
  • path — पाथ को दर्शाने वाले ज़्यादा से ज़्यादा 100 अक्षांश/देशांतर जोड़े की सूची. अक्षांश और देशांतर की वैल्यू को कॉमा लगाकर अलग किया जाना चाहिए. अक्षांश/देशांतर पेयर को पाइप वर्ण से अलग किया जाना चाहिए: "|". जब आप path पैरामीटर देते हैं, तो एपीआई पहले उस सड़क का पाथ स्नैप करता है जिस पर वाहन ले जाने की संभावना ज़्यादा होती है (जैसा कि snapToRoads अनुरोध के लिए होता है). इसके बाद, सही सड़क सेगमेंट की रफ़्तार की सीमा तय करता है. अगर आपको एपीआई से पाथ स्नैप नहीं करना है, तो आपको नीचे बताए गए तरीके से placeId पैरामीटर पास करना होगा. इस उदाहरण में, path पैरामीटर को तीन अक्षांश/देशांतर जोड़े के साथ दिखाया गया है: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • placeId — जगह के आईडी, जो एक या उससे ज़्यादा सड़क के हिस्सों को दिखाते हैं. पक्का करें कि हर जगह का आईडी, किसी सड़क के सेगमेंट को दिखाता हो, न कि किसी अलग तरह की जगह को. हर अनुरोध के साथ, ज़्यादा से ज़्यादा 100 प्लेस आईडी पास किए जा सकते हैं. एपीआई, दिए गए जगह के आईडी पर रोड-स्नैपिंग नहीं करता. अनुरोध में, जगह के हर आईडी के लिए रफ़्तार की सीमा तय की जाती है. सही जगह के आईडी ढूंढने के लिए, snapToRoads या nearestRoads का अनुरोध भेजें. इसके बाद, उन्हें speedLimits अनुरोध के लिए इनपुट के तौर पर दें. इस उदाहरण में, दो जगह के आईडी के साथ placeId पैरामीटर दिखाया गया है:placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
• key — आपके ऐप्लिकेशन की API कुंजी. जब भी आपका ऐप्लिकेशन हर अनुरोध के साथ एपीआई पासकोड शामिल करके, Roads API को अनुरोध भेजता है, तो ऐप्लिकेशन को अपनी पहचान ज़ाहिर करनी होगी. कुंजी पाने का तरीका जानें.

वैकल्पिक पैरामीटर

• units — रफ़्तार की सीमा किलोमीटर में दिखाना है या मील प्रति घंटे में. इसे KPH या MPH पर सेट किया जा सकता है. डिफ़ॉल्ट तौर पर, यह KPH पर सेट होती है.

जवाब

speedLimits रिस्पॉन्स में ये एलिमेंट मौजूद हो सकते हैं:

• speedLimits — सड़क के मेटाडेटा का कलेक्शन. हर एलिमेंट में ये फ़ील्ड होते हैं:
  • placeId — किसी जगह के लिए एक यूनीक आइडेंटिफ़ायर. Roads API से मिले सभी जगह के आईडी, सड़क के सेगमेंट से जुड़े होंगे.
  • speedLimit — सड़क के उस हिस्से के लिए रफ़्तार की सीमा.
  • units — KPH या MPH दिखाता है.
• snappedPoints — स्नैप किए गए पॉइंट का कलेक्शन. यह कलेक्शन सिर्फ़ तब मौजूद होता है, जब अनुरोध में path पैरामीटर शामिल हो. हर पॉइंट में ये फ़ील्ड होते हैं:
  • location — में latitude और longitude वैल्यू होती है.
  • originalIndex — एक पूर्णांक जो ओरिजनल अनुरोध में मौजूद वैल्यू को दिखाता है. अनुरोध की हर वैल्यू, रिस्पॉन्स में मौजूद स्नैप की गई वैल्यू से मैप होनी चाहिए. ये वैल्यू 0 से इंडेक्स की गई हैं. इसलिए, 4 के originalIndex वाले पॉइंट की वैल्यू, पांचवें अक्षांश/देशांतर की स्नैप की गई वैल्यू होगी जो path पैरामीटर को दिया गया है.
  • placeId — किसी जगह के लिए एक यूनीक आइडेंटिफ़ायर. Roads API से मिले सभी जगह के आईडी, सड़क के सेगमेंट से जुड़े होंगे. placeId को रफ़्तार की सीमा के अनुरोध में पास किया जा सकता है, ताकि उस सेगमेंट पर रफ़्तार की सीमा के बारे में पता चल सके.
• warning_message — ऐसी स्ट्रिंग जिसमें उपयोगकर्ता को दिखने वाली चेतावनी होती है.

पाथ का इस्तेमाल करने वाले अनुरोध का उदाहरण

इस अनुरोध में, पुर्तगाल के वास्को ड गामा पुल को पार करने वाले रास्ते में, तय किए गए अक्षांश/देशांतर जोड़े के नज़दीक की हर सड़क के सेगमेंट के लिए रफ़्तार की सीमा तय की जाती है.

अनुरोध करें

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

जवाब

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

ऊपर दिए गए जवाब में, पॉइंट की कमी के बारे में चेतावनी वाला मैसेज देखें. अगर आपने नज़दीकी सड़क के सेगमेंट के लिए, अपनी पसंद के हिसाब से रफ़्तार की सीमा तय करने का अनुरोध किया है, तो आपको speedLimits को कॉल करना होगा. इसके लिए, nearestRoads एंडपॉइंट से लोकेशन आईडी लेना होगा.

जगह के आईडी का इस्तेमाल करने वाले अनुरोध का उदाहरण

अक्षांश/देशांतर पेयर का इस्तेमाल करने के बजाय, सड़क के सेगमेंट के जगह के आईडी पास करें. हमारा सुझाव है कि आप snapToRoads या nearestRoads अनुरोधों का इस्तेमाल करके, सड़क के सेगमेंट के लिए जगह के आईडी पाएं. जगह के आईडी पास करने पर, एपीआई हर जगह के आईडी से दिखाए जाने वाले सड़क के सेगमेंट के लिए रफ़्तार की सीमा दिखाता है. एपीआई, दिए गए जगह के आईडी पर, रोड-स्नैपिंग को लागू नहीं करता.

नीचे दिए गए उदाहरण में, पुर्तगाल के लिस्बन में वास्को दा गामा पुल को पार करने वाले सड़कों के कुछ हिस्सों की रफ़्तार की सीमा के बारे में बताया गया है.

अनुरोध करें

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

जवाब

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

इस्तेमाल करने के सुझाव

स्पीड लिमिट सेवा को किए जाने वाले कॉल की संख्या को कम करने के लिए, हमारा सुझाव है कि आप अपनी ऐसेट की जगहों को 5 से 15 मिनट के अंतराल में रखें. सटीक वैल्यू, ऐसेट की यात्रा की रफ़्तार पर निर्भर करती है. अगर कोई ऐसेट स्थिर है, तो जगह का एक सैंपल काफ़ी है (इसके लिए, कई बार कॉल करने की ज़रूरत नहीं है).

हमारा सुझाव है कि मोबाइल ऐसेट की जगह की जानकारी मिलने पर, हर बार एपीआई को कॉल करने के बजाय, कुछ डेटा इकट्ठा होने पर स्पीड लिमिट सेवा को कॉल करें.

कुछ/सभी स्पीड सीमाएं क्यों नहीं हैं?

speedLimits के न होने की सबसे आम वजह, उस जगह के लिए रफ़्तार की सीमा का अनुरोध करना है जो सड़क वाला हिस्सा नहीं है.

ऊपर दिए गए उदाहरण में, कॉन्सेप्ट को समझाने के लिए वास्को ड गामा ब्रिज का इस्तेमाल किया गया है. यह पुल, रियो तेजो पर बनी E90 सड़क को पार करने के लिहाज़ से बनाया गया है. पुल का स्थान आईडी ChIJUzt97ZEwGQ0RM1JzQfqoDtU है. ऊपर दिए गए जवाब में, सड़क का पहला सेगमेंट E90 सड़क का हिस्सा है. इसका जगह का आईडी है ChIJX12duJAWGQ0Ra0d4Oi4jOGE. उदाहरण के लिए अनुरोध में, अगर सड़क की जगह के आईडी को पुल के जगह के आईडी से बदला जाता है, तो जवाब में speedLimits कलेक्शन में सिर्फ़ दो रफ़्तार सीमाएं होंगी. इसकी वजह यह है कि पुल का जगह का आईडी, सड़क के किसी सेगमेंट को नहीं दिखाता. इसके अलावा, अगर कोई भी प्लेस आईडी सड़क के सेगमेंट के लिए नहीं है, तो जवाब में रफ़्तार की कोई सीमा नहीं होगी.

जगह के आईडी का इस्तेमाल करके गति सीमा का अनुरोध करते समय, पक्का करें कि जगह का हर आईडी किसी सड़क के सेगमेंट को दिखाता हो, न कि अलग तरह की जगह को. अलग-अलग सड़क खंडों के लिए जगह के आईडी को snapToRoads या nearestRoads अनुरोधों का इस्तेमाल करके सबसे अच्छी तरह हासिल किया जाता है. इनमें से कोई भी एक कॉल से कई जगह का आईडी दे सकता है.