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=ChIJs5ydyTiuEmsR0fRSlU0C7k0&placeId=ChIJW__r4ERXzpQRgkeRL6P0m3Y
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 अनुरोधों का इस्तेमाल करके सबसे सही तरीके से वापस पाया जा सकता है. इनमें से कोई भी अनुरोध, एक ही कॉल से जगह के कई आईडी दिखा सकता है.
अगर किसी सड़क के सेगमेंट पर, कार और ट्रक के लिए स्पीड की अलग-अलग सीमाएं पोस्ट की गई हों, तो क्या होगा?
Roads API, सिर्फ़ ऑटोमोबाइल के लिए पोस्ट की गई ज़्यादा से ज़्यादा स्पीड लिमिट दिखाता है.