Isochrones API इस्तेमाल करने के सबसे सही तरीके

स्मूदिंग और फ़िडेलिटी

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

  • polygon_fidelity: रिज़ॉल्यूशन. इस विकल्प से, उन ग्रिड सेल (S2 सेल) के साइज़ को कंट्रोल किया जाता है जिनका इस्तेमाल, पहुंच वाले इलाके का हिसाब लगाने के लिए किया जाता है.
    • LOW: इसमें बड़ी ग्रिड सेल का इस्तेमाल किया जाता है. यह बड़े इलाकों को बिना किसी गैप के कवर करने के लिए सबसे अच्छा है. इससे सामान्य आकार मिलता है.
    • MEDIUM: सटीक और संतुलित.
    • HIGH: इसमें छोटी ग्रिड सेल का इस्तेमाल किया जाता है. इससे सड़क नेटवर्क के हिसाब से सटीक नतीजे मिलते हैं. हालांकि, इससे ऐसी जगहें या "होल" बन सकते हैं जहां सड़क नेटवर्क कम है.
    • डिफ़ॉल्ट: अगर कोई विकल्प नहीं चुना जाता है, तो सेवा, यात्रा की अवधि के हिसाब से फ़िडेलिटी को डाइनैमिक तरीके से चुनती है.
  • enable_smoothing: एस्थेटिक. इस विकल्प से यह कंट्रोल किया जाता है कि फ़िडेलिटी से तय की गई ग्रिड सेल के नुकीले किनारों को गोल किया जाए या नहीं.
    • false (रॉ): इससे सटीक ज्यामितीय कैलकुलेशन मिलती है. किनारे, ग्रिड सेल को दिखाते हुए उबड़-खाबड़ या सीढ़ीदार दिखते हैं. विश्लेषण के लिए सबसे सही है. जैसे, पॉइंट-इन-पॉलीगॉन टेस्ट.
    • true (स्मूद): यह पोस्ट-प्रोसेसिंग एल्गोरिदम लागू करके, किनारों को गोल करता है. मैप पर विज़ुअल डिसप्ले के लिए सबसे सही.

ये कैसे इंटरैक्ट करते हैं: फ़िडेलिटी, बेसलाइन की जानकारी सेट करती है. स्मूदिंग एल्गोरिदम इसी जानकारी के आधार पर काम करता है.

  • हाई फ़िडेलिटी + स्मूदिंग: इससे सड़क के आखिरी हिस्से का सटीक और नैचुरल दिखने वाला आकार बनता है.
  • कम फ़िडेलिटी + स्मूदिंग: इससे एक सामान्य "ब्लॉब" शेप बनता है.

पेलोड का साइज़ और रेंडरिंग

बड़े आइसोक्रोन में हज़ारों कोऑर्डिनेट हो सकते हैं. साथ ही, पेलोड 300 से 500 किलोबाइट के बीच हो सकते हैं.

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

गड़बड़ी ठीक करना

5xx सर्वर की गड़बड़ियों के लिए, एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करने का लॉजिक लागू करें. हालांकि, पैरामीटर में बदलाव किए बिना, 4xx क्लाइंट से जुड़ी गड़बड़ियों के लिए फिर से कोशिश न करें:

  • INVALID_ARGUMENT (400): पक्का करें कि आपकी अवधि पॉज़िटिव हो और चुने गए मोड की सीमा के अंदर हो. यह सीमा, ड्राइव और दोपहिया वाहन के लिए ज़्यादा से ज़्यादा 3,600 सेकंड या अन्य मोड के लिए 7,200 सेकंड है.
  • NOT_FOUND (404): शुरुआती पॉइंट को सड़क पर स्नैप नहीं किया जा सका. निर्देशांक को किसी जानी-पहचानी सड़क के आस-पास ले जाकर देखें या पक्का करें कि यह सुविधा उस इलाके में काम करती हो.