आइसोक्रोन जनरेट करने के लिए, एपीआई को शुरुआती जगह, यात्रा का तरीका (जैसे कि ड्राइविंग, साइकल चलाना या पैदल चलना) और समयसीमा की जानकारी दें. इसके अलावा, रूटिंग की प्राथमिकताओं और नतीजे के तौर पर मिले पॉलीगॉन के दिखने के तरीके में भी बदलाव किया जा सकता है.
टाइम होराइज़न
सेवा को दी जाने वाली मुख्य शर्त, travel_duration है. इससे यह तय होता है कि कैलकुलेशन के लिए, किस समयावधि का डेटा इस्तेमाल किया जाएगा.
- ज़्यादा से ज़्यादा अवधि: यह एपीआई,
DRIVEमोड के लिए ज़्यादा से ज़्यादा 3,600 सेकंड (एक घंटा) औरWALKऔरBICYCLEमोड के लिए 7,200 सेकंड (दो घंटे) की यात्रा में लगने वाला समय के साथ काम करता है. - परफ़ॉर्मेंस: कैलकुलेशन का समय, अनुरोध की गई अवधि और यात्रा के चुने गए तरीके के हिसाब से तय होता है. एक घंटे के ड्राइविंग आइसोक्रोन में, पैदल चलने के एक घंटे के आइसोक्रोन की तुलना में काफ़ी बड़ा भौगोलिक क्षेत्र और सड़क नेटवर्क शामिल होता है. इस वजह से, ड्राइविंग के अनुरोध में ज़्यादा समय लगता है.
ऑरिजिन पॉइंट और रोड स्नैपिंग
आइसोक्रोन के लिए शुरुआती पॉइंट को दो तरीकों से तय किया जा सकता है:
- निर्देशांक: अक्षांश और देशांतर का जोड़ा (
location). - जगह के आईडी: Google Maps पर किसी जगह की खास पहचान करने वाला यूनीक आइडेंटिफ़ायर
(
place). जगह का आईडी देने पर, सेवा उस जगह के केंद्रक का इस्तेमाल शुरुआती पॉइंट के तौर पर करती है. ध्यान दें कि एपीआई को संसाधन के नाम के फ़ॉर्मैट की ज़रूरत होती है. जैसे,places/ChIJ.... जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी देखें.
इनपुट के तरीके से कोई फ़र्क़ नहीं पड़ता. अगर कोई पॉइंट सड़क पर नहीं है, तो एपीआई उस पॉइंट से यात्रा में लगने वाले समय का हिसाब नहीं लगाता. जैसे, किसी पार्क या इमारत के अंदर. इस समस्या को हल करने के लिए, सेवा रोड स्नैपिंग का इस्तेमाल करती है. सड़क पर स्नैप करने की सुविधा में ये सुविधाएं शामिल हैं:
- स्मार्ट स्नैपिंग: यह सेवा, आपके शुरुआती पॉइंट को सड़क के सबसे नज़दीकी सेगमेंट पर स्नैप करने की कोशिश करती है.
- मोड के हिसाब से जानकारी: स्नैपिंग लॉजिक, आपके
travel_modeको ध्यान में रखता है. अगर आपनेDRIVEका अनुरोध किया है, तो एपीआई सिर्फ़ पैदल चलने के रास्तों को अनदेखा करता है और गाड़ी चलाने के लिए सबसे नज़दीकी सड़क ढूंढता है. अगर आपनेWALKका अनुरोध किया है, तो एपीआई पैदल चलने के रास्तों और फ़ुटपाथों को प्राथमिकता देता है. - एपीआई के काम न करने की स्थितियां: अगर एपीआई को आपके शुरुआती पॉइंट से करीब 100 मीटर के दायरे में कोई सही सड़क नहीं मिलती है, तो एपीआई
404 NOT_FOUNDगड़बड़ी का मैसेज दिखाता है. आम तौर पर, इसका मतलब यह होता है कि पॉइंट, सड़क नेटवर्क से बहुत दूर है या ऐसे इलाके में है जहां मैप डेटा, यात्रा के अनुरोध किए गए मोड के साथ काम नहीं करता है.
ट्रैफ़िक के बारे में जागरूकता
routing_preference पैरामीटर की मदद से, यह कंट्रोल करें कि ट्रैफ़िक की जानकारी से जनरेट हुए पॉलीगॉन पर किस तरह का असर पड़ता है:
TRAFFIC_UNAWARE(डिफ़ॉल्ट): यह पैरामीटर, स्पीड लिमिट और सड़क के टाइप के हिसाब से, आइसोक्रोन पॉलीगॉन जनरेट करता है. इससे एक ऐसा शेप जनरेट होता है जो दिन के समय के हिसाब से बदलता नहीं है. यह पैरामीटर, सामान्य विश्लेषण या बेसलाइन परिदृश्य की प्लानिंग के लिए सबसे सही है.TRAFFIC_AWARE: यह अनुरोध के समय, लाइव या अनुमानित ट्रैफ़िक की स्थितियों का इस्तेमाल करके आइसोक्रोन का हिसाब लगाता है. इससे, ट्रैफ़िक ज़्यादा होने पर पहुंचने लायक जगह कम हो जाती है और ट्रैफ़िक कम होने पर बढ़ जाती है.
स्मूदिंग और फ़िडेलिटी
polygon_fidelity और enable_smoothing पैरामीटर का इस्तेमाल करके, आउटपुट पॉलीगॉन को पसंद के मुताबिक बनाया जा सकता है. साथ ही, उनकी सटीक जानकारी को बेहतर बनाया जा सकता है. ये विकल्प अलग-अलग होते हैं, लेकिन ये मिलकर फ़ाइनल शेप तय करते हैं.
polygon_fidelity: इस विकल्प से, उस ग्रिड सेल के साइज़ को कंट्रोल किया जाता है जिसका इस्तेमाल, पहुंच वाले इलाके का हिसाब लगाने के लिए किया जाता है.LOW: इसमें बड़े ग्रिड सेल इस्तेमाल किए जाते हैं. यह बड़े इलाकों को बिना किसी गैप के कवर करने के लिए सबसे अच्छा है. इससे सामान्य आकार मिलता है.MEDIUM: सटीक अनुमान.HIGH: इसमें छोटी ग्रिड सेल का इस्तेमाल किया जाता है. इससे सड़क नेटवर्क के हिसाब से ज़्यादा सटीक नतीजे मिलते हैं. हालांकि, अगर सड़क नेटवर्क कम है, तो इससे खाली जगहें या गड्ढे दिख सकते हैं.POLYGON_FIDELITY_UNSPECIFIED: अगर यह जानकारी नहीं दी जाती है, तो सेवा, यात्रा की अवधि के हिसाब से फ़िडेलिटी को डाइनैमिक तरीके से चुनती है.
ज़्यादा, सामान्य, और कम पॉलीगॉन फ़िडेलिटी
enable_smoothing: इससे यह कंट्रोल किया जाता है कि फ़िडेलिटी से तय की गई ग्रिड सेल के नुकीले किनारों को गोल किया जाए या नहीं.false(रॉ): यह डिफ़ॉल्ट सेटिंग है. ज्यामिति से जुड़ी सटीक गणना दिखाता है. किनारे कटे-फटे या सीढ़ीदार दिखते हैं. विश्लेषण के लिए सबसे सही, जैसे कि पॉइंट-इन-पॉलीगॉन टेस्ट. स्मूद किए गए डेटा की तुलना में कम लेटेंसी.true(स्मूद): यह पोस्ट-प्रोसेसिंग एल्गोरिदम लागू करके, किनारों को गोल करता है. मैप पर विज़ुअल डिसप्ले के लिए सबसे अच्छा.
स्मूद और बिना स्मूद किए गए आइसोक्रोन