GMSNavigator क्लास रेफ़रंस

लिसनर जोड़ता है.

लिसनर को कमज़ोर रेफ़रंस के साथ रोका गया है.

पैरामीटर:

लिसनर

एक ऑब्जेक्ट, जो GMSNavigatorListener प्रोटोकॉल के मुताबिक है.

लिसनर को हटा देता है.

पैरामीटर:

लिसनर

एक ऑब्जेक्ट, जो GMSNavigatorListener प्रोटोकॉल के मुताबिक है.

लौटाए जाने वाले प्रॉडक्ट:

अगर लिसनर को हटा दिया गया है, तो 'हां' वैल्यू मिलती है. अगर ऑब्जेक्ट कोई लिसनर नहीं है, तो NO लौटाता है.

नेविगेशन के लिए कई डेस्टिनेशन सेट करता है. साथ ही, पहले से सेट किए गए डेस्टिनेशन को बदल देता है.

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

कॉलबैक को हमेशा, मुख्य सूची में एसिंक्रोनस तरीके से भेजा जाएगा.

नेविगेशन के लिए कई डेस्टिनेशन सेट करता है. साथ ही, पहले से सेट किए गए डेस्टिनेशन को बदल देता है.

रूटिंग विकल्पों का इस्तेमाल करके, लौटाए गए रास्तों की गिनती की जाती है.

पैरामीटर:

डेस्टिनेशन	डेस्टिनेशन वेपॉइंट का कलेक्शन.
routingOptions	वे विकल्प जो रूटिंग लॉजिक (रूटिंग रणनीति) पर असर डालते हैं.
कॉलबैक	यह तब कॉल किया जाता है, जब उपभोक्ता की जगह से, बताए गए डेस्टिनेशन पर जाने वाला कोई रूट मिलता है या RouteStatus में बताई गई किसी वजह से नहीं मिल पाता है.

यह नीति, पहले से तय किए गए रूट पर नेविगेट करने के लिए, रूट टोकन का इस्तेमाल करके, नेविगेशन के लिए कई डेस्टिनेशन सेट करती है.

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

जब नेविगेशन सेशन शुरू करने के लिए रूट टोकन का इस्तेमाल किया जाता है, तब सिर्फ़ GMSNavigationTravelModeDriving और GMSNavigationTravelModeTwoWheeler काम करते हैं. travelMode सेट करके यात्रा मोड कॉन्फ़िगर करें. अगर मौजूदा यात्रा मोड काम नहीं करता है, तो कॉल कनेक्ट नहीं होगा और कॉलबैक में GMSRouteStatusTravelModeUnsupported लौटा दिया जाएगा.

पैरामीटर:

डेस्टिनेशन	डेस्टिनेशन वेपॉइंट का कलेक्शन, रूट टोकन पाने के लिए RoutesPreferred API को दिए गए डेस्टिनेशन के जैसा ही होना चाहिए.
routeToken	RoutesPreferred API से मिला रूट टोकन स्ट्रिंग. RoutesPreferred API में दिए गए रूटिंग विकल्प, इस रूट टोकन में कोड में बदले जाते हैं. साथ ही, रूट को फिर से रूट करने पर, इनका इस्तेमाल पहले से गिने गए रूट या नए रूट को फिर से जनरेट करने के लिए किया जाएगा.
कॉलबैक	यह तब कॉल किया जाता है, जब उपभोक्ता की जगह से, बताए गए डेस्टिनेशन पर जाने वाला कोई रास्ता मिलता है या RouteStatus में बताई गई किसी वजह से वह नहीं मिल पाता.

रूटिंग रणनीति के आधार पर रास्ते की जानकारी दिखाता है: डिफ़ॉल्ट सबसे अच्छा या छोटा रास्ता.

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

पैरामीटर:

डेस्टिनेशन	गंतव्य वेपॉइंट.
routingOptions	रास्ते की जानकारी फ़ेच करने के लिए इस्तेमाल किए गए विकल्प. रूटिंग और वैकल्पिक मार्ग कार्यनीति को अनदेखा कर दिया जाता है, क्योंकि यह विधि सभी रूटिंग रणनीतियों के लिए मार्ग की जानकारी देती है.
कॉलबैक	रूट की जानकारी मिलने पर कॉलबैक को कॉल किया जाता है.

समर्थन नहीं होना या रुकना.

इसके बजाय गंतव्यों की नई सूची के साथ किसी एक -setDestinations:... विधि को कॉल करें.

गंतव्यों की वर्तमान सूची से पहले गंतव्य को पॉप करता है. इस कॉल के बाद, अगर कोई है, तो अगली मंज़िल की ओर दिशा-निर्देश दिए जाएंगे.

लौटाए जाने वाले प्रॉडक्ट:

वेपॉइंट दिशा-निर्देश अब दिशा में है. अगर कोई और वेपॉइंट नहीं बचा है, तो यह रास्ता काम नहीं करता.

ध्यान दें:

यह अब काम नहीं करता. इसके बजाय, किसी एक -setDestinations:... तरीके का इस्तेमाल करें.

पहले से सेट की गई सभी मंज़िलों को मिटा देता है. साथ ही, मैप से आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए सभी रास्तों को हटा देता है.

अगर दिशा-निर्देश चालू है, तो यह अपने-आप रुक जाएगा.

दिए गए वेपॉइंट पर अनुमानित समय लौटाता है, या अगर वेपॉइंट मौजूदा रास्ते का हिस्सा नहीं है, तो CLTimeIntervalMax पर भेजता है.

दिशा-निर्देश चालू रहने पर, डिवाइस की मौजूदा स्थिति के हिसाब से इसे अपडेट किया जाता है.

अगर दिया गया वेपॉइंट मौजूदा रूट का कोई डेस्टिनेशन नहीं है, तो CLTimeIntervalMax दिखाता है.

दिए गए वेपॉइंट की अनुमानित दूरी या अगर वेपॉइंट मौजूदा रास्ते का हिस्सा नहीं है, तो CLLocationLocationMax दिखाता है.

दिशा-निर्देश चालू रहने के दौरान, डिवाइस की मौजूदा स्थिति के हिसाब से इसे अपडेट किया जाएगा.

अगर दिया गया वेपॉइंट, मौजूदा रूट का कोई डेस्टिनेशन नहीं है, तो CLLocationLocationMax दिखाता है.

मौजूदा नेविगेशन सेशन के दौरान नेविगेशन इवेंट पर लागू होने वाले मौजूदा ट्रांज़ैक्शन आईडी को सर्वर पर सेट और लॉग करता है.

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

पैरामीटर:

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

यह तब कॉल किया जाता है, जब डिवाइस की जगह से, बताए गए डेस्टिनेशन तक कोई रूट मिलता है या राऊटर की स्थिति बताने वाली किसी वजह से वह नहीं मिल पाता.

यह तब कॉल किया जाता है, जब दिए गए वेपॉइंट तक के रास्ते की जानकारी (ETA और दूरी) कैलकुलेट की जाती है.

पैरामीटर:

routeInfo

दिए गए डेस्टिनेशन के लिए रास्ते की जानकारी. कैलकुलेशन फ़ेल होने पर, वैल्यू नहीं दिखेगी.

इस लेन-देन आईडी को तब कॉल किया जाता है, जब setTransactionIDs के ज़रिए ट्रांज़ैक्शन आईडी सेट नहीं होते.

ज़्यादा जानकारी के लिए, एपीआई के दस्तावेज़ देखें.

मंज़िलों के लिए रास्ते जनरेट करते समय हाइवे से बचना है या नहीं.

डिफ़ॉल्ट रूप से 'नहीं' होता है.

मंज़िलों के लिए रास्ते जनरेट करते समय टोल सड़कों से बचना है या नहीं.

डिफ़ॉल्ट रूप से 'नहीं' होता है.

मंज़िलों के लिए रास्ते जनरेट करते समय फ़ेरी से बचना है या नहीं.

डिफ़ॉल्ट रूप से 'हां' होता है.

लाइसेंस प्लेट पर पाबंदी लगाने के लिए, लाइसेंस प्लेट के मौजूदा आखिरी अंक और देश के कोड का इस्तेमाल करें.

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

अगर लाइसेंस प्लेट की पाबंदी न हो, तो शून्य पर सेट करें. डिफ़ॉल्ट वैल्यू शून्य है.

फ़िलहाल, मोड़-दर-मोड़ मार्गदर्शन चालू है या नहीं.

अगर दिशा-निर्देश 'हां' है, लेकिन अभी कोई रास्ता उपलब्ध नहीं है, तो रूट उपलब्ध होने पर निर्देश शुरू हो जाएगा. अगर clearDestinations कॉल किया जाता है या हम किसी वेपॉइंट पर पहुंच जाते हैं, तो इस प्रॉपर्टी को 'नहीं' पर सेट कर दिया जाएगा.

-navigator:didपहुंचAtWaypoint: को कॉल किए जाने पर, दिशा-निर्देश अपने-आप बंद हो जाना चाहिए या नहीं.

'नहीं' होने पर, पेज पर पहुंचने के बाद भी नेविगेशन हेडर और फ़ुटर दिखते रहेंगे. नेविगेशन हेडर, दिशा-निर्देश का आखिरी चरण दिखाता रहेगा. साथ ही, नेविगेशन फ़ुटर बाकी बचे समय और दूरी को तब तक अपडेट करता रहेगा, जब तक कि समय/दूरी 0 तक नहीं पहुंच जाती. इसके अलावा, -navigator:didUpdateRemainingTime और -navigator:didUpdateRemaining काफ़ी के अपडेट जारी रहेंगे. दिशा-निर्देश और बाकी समय/दूरी के अपडेट बंद करने के लिए guidanceActive को साफ़ तौर पर नहीं पर सेट करें.

अगर हां, तो guidanceActive में पहुंचने पर, यह अपने-आप 'नहीं' पर सेट हो जाएगा.

डिफ़ॉल्ट रूप से 'हां' होता है.

अगली मंज़िल तक पहुंचने के अनुमानित समय में कम से कम बदलाव, जिससे navigator:didUpdateRemainingTime: तरीके को कॉल करने के लिए ट्रिगर होगा.

अगर इसे NSTimeIntervalMax पर सेट किया जाता है, तो टाइम अपडेट के कॉलबैक बंद हो जाएंगे. अगर इसे नेगेटिव वैल्यू पर सेट किया जाता है, तो एक सेकंड की डिफ़ॉल्ट थ्रेशोल्ड का इस्तेमाल किया जाएगा. डिफ़ॉल्ट रूप से एक सेकंड होता है.

ध्यान दें:

अगर कोई लिसनर navigator:didUpdateRemainingTime: को लागू नहीं करता, तो इस वैल्यू को अनदेखा कर दिया जाता है.

अगली मंज़िल की अनुमानित दूरी में कम से कम बदलाव, जिससे navigator:didUpdateRemainingDistance: तरीके को कॉल करने के लिए ट्रिगर होगा.

अगर इसे CLLocationLocationMax पर सेट किया जाता है, तो दूरी अपडेट करने वाले कॉलबैक बंद कर दिए जाएंगे. अगर इसे नेगेटिव वैल्यू पर सेट किया जाता है, तो एक मीटर की डिफ़ॉल्ट थ्रेशोल्ड का इस्तेमाल किया जाएगा. इसका डिफ़ॉल्ट साइज़ एक मीटर होता है.

ध्यान दें:

अगर कोई लिसनर navigator:didUpdateRemainingDistance: को लागू नहीं करता, तो इस वैल्यू को अनदेखा कर दिया जाता है.

अगली मंज़िल तक पहुंचने का अनुमानित समय दिखाता है.

दिशा-निर्देश चालू रहने के दौरान, डिवाइस की मौजूदा स्थिति के हिसाब से इसे अपडेट किया जाएगा.

कोई रास्ता उपलब्ध न होने पर, CLTimeIntervalMax दिखाता है.

अगली मंज़िल की अनुमानित दूरी दिखाता है.

दिशा-निर्देश चालू रहने के दौरान, डिवाइस की मौजूदा स्थिति के हिसाब से इसे अपडेट किया जाएगा.

कोई रास्ता उपलब्ध न होने पर, CLLocationLocationMax दिखाता है.

देरी की कैटगरी को अगले डेस्टिनेशन पर ले जाता है.

दिशा-निर्देश चालू रहने के दौरान, डिवाइस की मौजूदा स्थिति के हिसाब से इसे अपडेट किया जाएगा.

अगर कोई रास्ता उपलब्ध नहीं है या ट्रैफ़िक का डेटा उपलब्ध नहीं है, तो GMSनेविगेशनOptionsCategoryNoData दिखाता है.

यात्रा का मौजूदा चरण.

इस GMSRouteLeg की पोज़िशन, डिवाइस की सबसे हाल ही की (रोड-स्नैप की गई) पोज़िशन से शुरू होती है.

रूट लेग का कलेक्शन, जहां हर लेग सेट किए गए डेस्टिनेशन से मेल खाता है.

उपयोगकर्ता जिस पाथ से हाल ही में दिशा-निर्देशों के सेशन में गया था उसे 'हां' पर सेट किया गया था. इसे पिछली बार के दिशा-निर्देश के तौर पर 'हां' पर सेट किया गया था.

पथ में सड़क-स्नैप की गई जगहें होती हैं, जिन्हें GMSRoadSnappedLocationProvider दिखाता है. इस वजह से, लाइन सेगमेंट बनाने में आसानी होती है.

ध्यान दें:

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

यह तय करता है कि ट्रैफ़िक और मोड़-दर-मोड़ अलर्ट के लिए, आवाज़ से रास्ता बताने की सुविधा चालू होनी चाहिए या नहीं.

डिफ़ॉल्ट तौर पर, यह GMSनेविगेशनVoiceguidelinesAlertsAndguidelines पर डिफ़ॉल्ट होता है.

इससे यह तय किया जाता है कि आवाज़ से रास्ता बताने की सुविधा किन ऑडियो डिवाइसों पर चल सकती है.

डिफ़ॉल्ट तौर पर, यह GMSVoiceguidelinesऑडियोDeviceTypeब्लूटूथ पर सेट होता है.

इससे यह तय किया जाता है कि बोलकर दी जाने वाली सूचनाओं को चलाने पर डिवाइस वाइब्रेट होगा या नहीं.

यह तय करता है कि ऐप्लिकेशन के बैकग्राउंड में होने पर, दिशा-निर्देश की जानकारी वाले UILocalNotifications पेश किए जाएंगे या नहीं.

डिफ़ॉल्ट रूप से 'हां' होता है.

डिवाइस की जगह और दिन के समय के आधार पर, सुझाया गया लाइटिंग मोड.

इससे यह तय होता है कि ट्रैफ़िक, बेहतर रास्तों, और घटनाओं के लिए प्रॉम्प्ट दिखाए जाने चाहिए या नहीं.

डिफ़ॉल्ट रूप से 'हां' होता है.

GMSनेविगेशनSpeedAlertSeverity के लिए, ट्रिगर करने के थ्रेशोल्ड को अपने हिसाब से बनाने के लिए, GMSNavigationSpeedAlertOptions.

इस प्रॉपर्टी का इस्तेमाल करके, छोटे और बड़े, दोनों तरह के अलर्ट के प्रतिशत में, स्पीड अलर्ट के ट्रिगर होने के थ्रेशोल्ड को अपने हिसाब से सेट किया जा सकता है. इस तरीके का इस्तेमाल करके, अहम स्पीड अलर्ट के लिए, समय के हिसाब से ट्रिगर किए जाने वाले थ्रेशोल्ड को अपने हिसाब से सेट किया जा सकता है.

शून्य को सेट करने पर, आपको कोई भी तेज़ स्पीड वाला फ़ीड डेटा नहीं मिलेगा और NavSDK का डिफ़ॉल्ट स्पीड अलर्ट दिखेगा: स्पीड अलर्ट, स्पीड सीमा से 5 मील प्रति घंटा या 10 किलोमीटर प्रति घंटा से ज़्यादा होने पर लाल टेक्स्ट दिखाता है और 10 मील प्रति घंटे या 20 किलोमीटर प्रति घंटे से ज़्यादा की स्पीड होने पर, सफ़ेद टेक्स्ट और लाल बैकग्राउंड दिखाता है.