गति सीमाएं

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 — आपके ऐप्लिकेशन की एपीआई कुंजी. जब भी 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."
}

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

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

अक्षांश/देशांतर की जोड़ी का इस्तेमाल करने के बजाय, आपके पास सड़क के सेगमेंट के जगह के आईडी पास करने का विकल्प है. हमारा सुझाव है कि आप 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 अनुरोधों का इस्तेमाल करके सबसे अच्छे तरीके से हासिल किए जाते हैं. इनमें से कोई भी एक अनुरोध, एक ही कॉल के कई जगह के आईडी दिखा सकता है.