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