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