वीडियो के विषय से जुड़े मुख्य कॉन्सेप्ट

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

टाइम होराइज़न

सेवा को दी जाने वाली मुख्य शर्त, travel_duration है. इससे यह तय होता है कि कैलकुलेशन के लिए, किस समयावधि का डेटा इस्तेमाल किया जाएगा.

• ज़्यादा से ज़्यादा अवधि: यह एपीआई, DRIVE और TWO_WHEELER मोड के लिए, यात्रा में लगने वाले ज़्यादा से ज़्यादा समय को 3,600 सेकंड (एक घंटा) तक सपोर्ट करता है. साथ ही, WALK और BICYCLE मोड के लिए, यात्रा में लगने वाले ज़्यादा से ज़्यादा समय को 7,200 सेकंड (दो घंटे) तक सपोर्ट करता है.
• परफ़ॉर्मेंस: कैलकुलेशन का समय, अनुरोध की गई अवधि और यात्रा के चुने गए तरीके के हिसाब से तय होता है. एक घंटे के ड्राइविंग आइसोक्रोन में, पैदल चलने के एक घंटे के आइसोक्रोन की तुलना में काफ़ी बड़ा भौगोलिक क्षेत्र और सड़क नेटवर्क शामिल होता है. इस वजह से, ड्राइविंग के अनुरोध में ज़्यादा समय लगता है.
• फ़ॉर्मैटिंग: एपीआई, google.protobuf.Duration का इस्तेमाल करता है. इसलिए, अवधि को पूर्णांक के बजाय, "s" पर खत्म होने वाली स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाना चाहिए. उदाहरण के लिए, "3600s".

ऑरिजिन पॉइंट और रोड स्नैपिंग

आइसोक्रोन के लिए यात्रा शुरू करने की जगह को दो तरीकों से तय किया जा सकता है:

• निर्देशांक: अक्षांश और देशांतर का जोड़ा (location).
• जगह के आईडी: Google Maps (place) पर किसी जगह की खास पहचान करने वाला आईडी. जगह का आईडी देने पर, सेवा उस जगह के केंद्र बिंदु को शुरुआती पॉइंट के तौर पर इस्तेमाल करती है. ध्यान दें कि एपीआई को रिसॉर्स के नाम का फ़ॉर्मैट चाहिए. जैसे, places/ChIJ.... जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी देखें.

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

• स्मार्ट स्नैपिंग: यह सेवा, आपके शुरुआती पॉइंट को सबसे नज़दीकी सड़क सेगमेंट पर स्नैप करने की कोशिश करती है.
• मोड की जानकारी: स्नैपिंग लॉजिक, आपकी travel_mode को ध्यान में रखता है. DRIVE या TWO_WHEELER का अनुरोध करने पर, एपीआई सिर्फ़ पैदल चलने वालों के लिए बने रास्तों को अनदेखा करता है और गाड़ी चलाने के लिए सबसे नज़दीकी सड़क ढूंढता है. WALK का अनुरोध करने पर, एपीआई पैदल चलने के रास्तों और फ़ुटपाथों को प्राथमिकता देता है.
• एपीआई के काम न करने की स्थितियां: अगर एपीआई को आपके शुरुआती पॉइंट के स्नैपिंग डिस्टेंस (यात्रा के मोड के हिसाब से, यह दूरी करीब 150 से 200 मीटर होती है: DRIVE और TWO_WHEELER के लिए 200 मीटर, BICYCLE के लिए 180 मीटर, और WALK के लिए 150 मीटर) के अंदर कोई सही सड़क सेगमेंट नहीं मिलता है, तो एपीआई 404 NOT_FOUND गड़बड़ी दिखाता है. आम तौर पर, इसका मतलब यह होता है कि पॉइंट, सड़क नेटवर्क से बहुत दूर है या किसी ऐसे इलाके में है जहां मैप डेटा, यात्रा के अनुरोध किए गए तरीके के साथ काम नहीं करता.

यात्रा की दिशा (बाहर से शहर के अंदर आना बनाम शहर से बाहर जाना)

travelDirection पैरामीटर का इस्तेमाल करके, इनबाउंड और आउटबाउंड, दोनों तरह की पहुंच का हिसाब लगाया जा सकता है:

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

ट्रैफ़िक के बारे में जानकारी

routing_preference पैरामीटर की मदद से, यह कंट्रोल करें कि ट्रैफ़िक की जानकारी से जनरेट हुए पॉलीगॉन पर किस तरह का असर पड़ता है:

• TRAFFIC_UNAWARE (डिफ़ॉल्ट): यह आइसोक्रोन पॉलीगॉन जनरेट करने के लिए, गति की सीमाओं और सड़क के क्रम का इस्तेमाल करता है. इससे एक ऐसा शेप बनता है जो दिन के समय के हिसाब से बदलता नहीं है. यह पैरामीटर, सामान्य विश्लेषण या बेसलाइन परिदृश्य की योजना बनाने के लिए सबसे सही है.
• TRAFFIC_AWARE: यह सुविधा, अनुरोध के समय के हिसाब से लाइव या अनुमानित ट्रैफ़िक की स्थितियों का इस्तेमाल करके, आइसोक्रोन का हिसाब लगाती है. इससे, ट्रैफ़िक ज़्यादा होने पर पहुंचने लायक इलाके का दायरा कम हो जाता है और ट्रैफ़िक कम होने पर यह दायरा बढ़ जाता है. ध्यान दें: ट्रैफ़िक की जानकारी के हिसाब से रूट की सुविधा सिर्फ़ तब काम करती है, जब travel_mode को DRIVE या TWO_WHEELER पर सेट किया गया हो.

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

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

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

• polygon_fidelity: इस विकल्प से, उस ग्रिड सेल के साइज़ को कंट्रोल किया जाता है जिसका इस्तेमाल, पहुंच वाले इलाके का हिसाब लगाने के लिए किया जाता है.

  • LOW: इसमें बड़े ग्रिड सेल इस्तेमाल किए जाते हैं. यह बड़े इलाकों को बिना किसी गैप के कवर करने के लिए सबसे अच्छा है. इससे सामान्य आकार मिलता है.
  • MEDIUM: सटीक और संतुलित जवाब.
  • HIGH: इसमें छोटी ग्रिड सेल का इस्तेमाल किया जाता है. इससे सड़क नेटवर्क के हिसाब से ज़्यादा सटीक नतीजे मिलते हैं. हालांकि, अगर सड़क नेटवर्क कम है, तो इससे खाली जगहें या गड्ढे दिख सकते हैं.
  • POLYGON_FIDELITY_UNSPECIFIED: अगर यह जानकारी नहीं दी जाती है, तो सेवा यात्रा की अवधि के हिसाब से, फ़िडेलिटी को डाइनैमिक तरीके से चुनती है.

    

    ज़्यादा, मीडियम, और कम पॉलीगॉन फ़िडेलिटी

• enable_smoothing: इससे यह कंट्रोल किया जाता है कि फ़िडेलिटी से तय की गई ग्रिड सेल के नुकीले किनारों को गोल किया जाए या नहीं.

  • false (रॉ): यह डिफ़ॉल्ट सेटिंग है. ज्यामिति से जुड़ी सटीक गणना दिखाता है. किनारे कटे-फटे या सीढ़ीदार दिखते हैं. यह मॉडल, विश्लेषण के लिए सबसे सटीक है. जैसे, पॉइंट-इन-पॉलीगॉन टेस्ट. स्मूद किए गए डेटा की तुलना में कम लेटेंसी.
  • true (स्मूद किया गया): इसमें पोस्ट-प्रोसेसिंग एल्गोरिदम लागू होता है, ताकि कोनों को गोल किया जा सके. मैप पर विज़ुअल डिसप्ले के लिए सबसे अच्छा.

    

    स्मूद और बिना स्मूद किए गए आइसोक्रोन