Isochrones API के बारे में अक्सर पूछे जाने वाले सवाल

मैं इनबाउंड "काम पर जाने" के लिए आइसोक्रोन (मंज़िल तक यात्रा करना) बनाम आउटबाउंड आइसोक्रोन (शुरुआती जगह से यात्रा करना) का हिसाब कैसे लगाऊं?

v1 एपीआई में, इनबाउंड और आउटबाउंड, दोनों तरह के कैलकुलेशन किए जा सकते हैं. इसके लिए, travelDirection (travel_direction) पैरामीटर का इस्तेमाल करें:

  • FROM (आउटबाउंड): यह फ़ंक्शन, तय की गई समयसीमा के अंदर, शुरुआती पॉइंट से from पहुंचने लायक इलाके का हिसाब लगाता है. यह डिलीवरी ज़ोन या सेवा कवरेज जैसे मामलों के लिए सही है.

  • TO (इनबाउंड): यह उस इलाके का हिसाब लगाता है जहां से तय समयसीमा के अंदर, शुरुआती पॉइंट to तक पहुंचा जा सकता है. यह सुविधा, ऑफ़िस जाने के लिए इस्तेमाल होने वाले ऐप्लिकेशन या किसी मुख्य ऑफ़िस या बस, मेट्रो वगैरह के हब के आस-पास के कैचमेंट ज़ोन का पता लगाने के लिए सही है.

यात्रा के चार मोड (DRIVE, TWO_WHEELER, BICYCLE, और WALK) एक-दूसरे से कैसे अलग हैं?

हर मोड, सड़क नेटवर्क के ऐक्सेस के अपने नियमों, टर्न कॉस्ट, और स्पीड मॉडल का इस्तेमाल करता है:

  • DRIVE: यह उन सड़कों को दिखाता है जिन पर गाड़ी चलाई जा सकती है. इसके लिए, पोस्ट की गई या बिना किसी रुकावट के चलने वाली स्पीड या लाइव ट्रैफ़िक स्पीड (TRAFFIC_AWARE) का इस्तेमाल किया जाता है. यह 3,600 सेकंड (60 मिनट) तक की यात्रा के लिए होता है.
  • TWO_WHEELER: यह मोड, मोटर से चलने वाले दोपहिया वाहनों के लिए उपलब्ध सड़कों पर यात्रा करने के लिए है. इसमें, तेज़ रफ़्तार वाली सड़कों पर DRIVE की तुलना में कम रफ़्तार वाले मॉडल का इस्तेमाल किया जाता है. साथ ही, इसमें TRAFFIC_AWARE रूटिंग का विकल्प भी होता है. इसमें 3,600 सेकंड (60 मिनट) तक का समय लगता है. इस वजह से, तेज़ रफ़्तार वाले हाइवे पर TWO_WHEELER का आइसोक्रोन, BICYCLE से बड़ा होता है, लेकिन DRIVE से छोटा होता है.
  • BICYCLE: यह साइकल चलाने के लिए उपलब्ध सड़कों, साइकल के रास्तों, और पगडंडियों को कवर करता है. इसमें सड़क के टाइप और ढलान के हिसाब से स्पीड अडजस्ट की जाती है. इसमें मोटरवे और फ़्रीवे शामिल नहीं हैं. इसमें 7,200 सेकंड (120 मिनट) तक का समय लगता है.
  • WALK: पैदल चलने वालों के लिए बने फ़ुटपाथ, रास्तों, और सड़कों पर पैदल चलने की रफ़्तार के हिसाब से तय की गई दूरी. इसमें ढलान के हिसाब से रफ़्तार को अडजस्ट किया जाता है. साथ ही, वाहनों के लिए वन-वे की पाबंदियों को अनदेखा किया जाता है. यह दूरी, 7,200 सेकंड (120 मिनट) तक की हो सकती है.

क्या Isochrones API में फ़ेरी या वॉटर क्रॉसिंग शामिल हैं?

नहीं. Isochrones API सिर्फ़ सड़क, पुल, सुरंग, और पाथवे कनेक्शन को पार करता है. यात्रा के सभी मोड में, फ़ेरी के रास्ते और पानी के रास्ते से यात्रा करने के विकल्प शामिल नहीं हैं. मुख्य भूमि से जनरेट किए गए आइसोक्रोन में, ऐसे द्वीप या प्रायद्वीप शामिल नहीं किए जाएंगे जो सिर्फ़ फ़ेरी से जुड़े हों.

कभी-कभी, वापस किया गया पॉलीगॉन ब्लॉक जैसा दिखता है या उसके किनारे आड़े-तिरछे और सीढ़ीदार होते हैं. खास तौर पर, लंबी अवधि के लिए. जानकारी के लेवल में बदलाव क्यों होता है?

Isochrones API, अनुरोध किए गए travel_duration और travel_mode के आधार पर, अपने स्पेशल कैलकुलेशन ग्रिड के रिज़ॉल्यूशन को डाइनैमिक तौर पर अडजस्ट करता है:

  • कम अवधि: ज़्यादा रिफ़ाइन किए गए और हाई रिज़ॉल्यूशन वाले ग्रिड का इस्तेमाल करें, क्योंकि कुल इलाका छोटा होता है. इससे ज़्यादा जानकारी वाली सीमा मिलती है.
  • ज़्यादा समय के लिए: ज़्यादा समय के लिए, कम रिज़ॉल्यूशन वाले ग्रिड का इस्तेमाल करें. इससे बड़े भौगोलिक इलाके को आसानी से कवर किया जा सकता है. साथ ही, इंतज़ार का समय भी कम रहता है.

अगर आपको वीडियो की अवधि के हिसाब से नहीं, बल्कि एक तय लेवल पर लगातार जानकारी चाहिए, तो वैकल्पिक polygon_fidelity को HIGH, MEDIUM या LOW पर सेट किया जा सकता है.

किसी पार्क, झील या बड़े इंडस्ट्रियल कॉम्प्लेक्स के अंदर मौजूद निर्देशांक के लिए, आइसोक्रोन का अनुरोध करने पर कभी-कभी "नहीं मिला" गड़बड़ी क्यों दिखती है?

Isochrones API, सड़कों और रास्तों का इस्तेमाल करके यात्रा में लगने वाले समय का हिसाब लगाता है. अगर आपके अनुरोध किए गए ऑरिजिन के निर्देशांक किसी पहचानी गई सड़क पर नहीं हैं, तो एपीआई को कैलकुलेशन शुरू करने से पहले, पॉइंट को सबसे नज़दीकी और काम करने वाले सेगमेंट पर "स्नैप" करना होगा.

यात्रा के हर मोड के लिए, स्नैपिंग की ज़्यादा से ज़्यादा दूरी करीब 200 मीटर या इससे कम होती है. WALK और BICYCLE, DRIVE और TWO_WHEELER की तुलना में कम दूरी वाले रास्ते दिखाते हैं. साथ ही, DRIVE और TWO_WHEELER, सिर्फ़ पैदल चलने वालों के लिए बने रास्तों को अनदेखा करते हैं.

अगर आपका ऑरिजिन कोऑर्डिनेट, मोड के साथ काम करने वाले मान्य सड़क सेगमेंट से इस दूरी से ज़्यादा दूर है, तो स्नैपिंग नहीं हो पाती है. साथ ही, एपीआई NOT_FOUND गड़बड़ी दिखाता है. इस समस्या को हल करने के लिए, पक्का करें कि आपके निर्देशांक किसी सार्वजनिक सड़क या रास्ते के आस-पास हों.

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

ट्रैफ़िक का हाल (TRAFFIC_AWARE) यात्रा के DRIVE और TWO_WHEELER मोड के लिए उपलब्ध है. अगर आपने WALK या BICYCLE के लिए आइसोक्रोन का अनुरोध किया और routingPreference को TRAFFIC_AWARE पर सेट किया, तो एपीआई 400 INVALID_ARGUMENT गड़बड़ी दिखाएगा.

जब मैं अपने मैप पर GeoJSON रिस्पॉन्स को रेंडर करता/करती हूं, तो आकार गलत जगह पर दिखता है, खराब दिखता है या रेंडर नहीं हो पाता. इसकी वजह क्या है?

आम तौर पर, ऐसा कोऑर्डिनेट ऑर्डर के मेल न खाने की वजह से होता है.

GeoJSON स्टैंडर्ड (आरएफ़सी 7946) के मुताबिक, Isochrones API, [longitude, latitude] के क्रम में निर्देशांक दिखाता है. हालांकि, कई मैपिंग एसडीके और कस्टम ज्यामिति ऑब्जेक्ट, [latitude, longitude] के क्रम में निर्देशांकों की उम्मीद करते हैं.

अगर आपका मैप सही तरीके से रेंडर नहीं हो रहा है, तो देखें कि आपका मैप एसडीके, GeoJSON को कैसे मैनेज करता है:

  • Google Maps JavaScript API: अगर डेटा लेयर (map.data.addGeoJson()) का इस्तेमाल किया जा रहा है, तो यह क्रम अपने-आप मैनेज हो जाता है. इसके लिए, आपको कुछ करने की ज़रूरत नहीं है.
  • कस्टम ऑब्जेक्ट या अन्य SDK टूल: अगर आपको रिस्पॉन्स को मैन्युअल तरीके से LatLng ऑब्जेक्ट में पार्स करना है, तो आपको GeoJSON पेलोड में मौजूद निर्देशांकों को लूप करना होगा. साथ ही, रेंडर करने से पहले [lng, lat] वैल्यू को [lat, lng] पेयर में ट्रांसपोज़ करना होगा.

मेरे आइसोक्रोन पॉलीगॉन में खाली "छेद" क्यों हैं? क्या मुझे इसके बजाय कोई ठोस आकार मिल सकता है?

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

एक्सटर्नल v1 API, होल को अपने-आप हटाने के लिए कोई पैरामीटर नहीं दिखाता. अगर आपके ऐप्लिकेशन को एक ठोस सीमा की ज़रूरत है, उदाहरण के लिए, पॉइंट-इन-पॉलीगॉन कंटेनमेंट की जांच करने के लिए, तो ये काम किए जा सकते हैं:

  • polygon_fidelity पैरामीटर को MEDIUM या LOW पर सेट करें, ताकि एल्गोरिदम को इन इंटरनल गैप को सामान्य बनाने और मर्ज करने के लिए बढ़ावा दिया जा सके.
  • GeoJSON को पार्स करने के लिए, Turf.js जैसी क्लाइंट-साइड जीआईएस लाइब्रेरी का इस्तेमाल करें. साथ ही, सिर्फ़ पहले कोऑर्डिनेट रिंग (बाहरी शेल) को निकालें और बाद के किसी भी अंदरूनी रिंग (छेद) को खारिज करें.

क्या मुझे बैकएंड स्पेशल एनालिसिस के लिए, enable_smoothing विकल्प चालू करना चाहिए?

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

सटीक स्पेशल ऐनलिसिस के लिए, स्मूथिंग का सुझाव नहीं दिया जाता. इसकी वजह यह है कि इससे वर्टिस में बदलाव होता है और सीमाएं थोड़ी शिफ़्ट हो जाती हैं. बैकएंड कैलकुलेशन, डेटाबेस क्वेरी या पॉइंट-इन-पॉलीगॉन टेस्ट के लिए, enable_smoothing को false पर सेट रखें. इससे यह पक्का किया जा सकेगा कि गणित के हिसाब से सटीक बाउंड्री का इस्तेमाल किया जा रहा है.