नेविगेशन एपीआई

पब्लिक फ़ाइनल क्लास NavigationApi ऑब्जेक्ट की विस्तार से जानकारी देता है

नेविगेशन एपीआई की एंट्री पॉइंट. Navigator का रेफ़रंस पाने के लिए, इस क्लास के स्टैटिक तरीकों का इस्तेमाल करें.

नेस्ट की गई क्लास की खास जानकारी

@इंटरफ़ेस	NavigationApi.ErrorCode		गड़बड़ी कोड एक स्टेटस कोड है, जो getNavigator(Activity, NavigatorListener) और getNavigator(Application, NavigatorListener) के ज़रिए तब दिखाया जाता है, जब Navigator नहीं मिल पाता.
इंटरफ़ेस	NavigationApi.NavigatorListener		बताए गए Navigator के स्टेटस के बारे में सूचना पाने के लिए, getNavigator(Activity, NavigatorListener) के साथ NavigatorListener रजिस्टर करें.
इंटरफ़ेस	NavigationApi.OnTermsResponseListener		उपयोगकर्ता के नियम और शर्तों को स्वीकार या अस्वीकार करने पर सूचना पाने के लिए, showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) के साथ OnTermsResponseListener को रजिस्टर करें.

सार्वजनिक तरीके से जुड़ी खास जानकारी

स्टैटिक बूलियन	areTermsAccepted(ऐप्लिकेशन का आवेदन) अगर उपयोगकर्ता ने पहले Google नेविगेशन के नियमों और शर्तों को स्वीकार किया है, तो true दिखाता है.
स्टैटिक शून्य	क्लीनअप() NavSDK के कॉम्पोनेंट की अंदरूनी स्थिति को साफ़ करता है.
सिंक किया गया स्टैटिक ForegroundServiceManager	getForegroundServiceManager(ऐप्लिकेशन ऐप्लिकेशन) सिंगलटन ForegroundServiceManager इंस्टेंस हासिल करता है.
स्टैटिक स्ट्रिंग	getNavSDKVersion() NavSDK का मौजूदा वर्शन दिखाता है.
स्टैटिक शून्य	getNavigator(ऐप्लिकेशन ऐप्लिकेशन, NavigationApi.NavigatorListener कॉलबैक) Navigator इंस्टेंस लेता है.
स्टैटिक शून्य	getNavigator(गतिविधि गतिविधि, NavigationApi.NavigatorListener कॉलबैक, TermsAndConditionsCheckOptionशर्तें-जांच) Navigator इंस्टेंस लेता है.
स्टैटिक शून्य	getNavigator(गतिविधि गतिविधि, NavigationApi.NavigatorListener कॉलबैक) getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED} के बराबर.
स्टैटिक शून्य	getNavigatorNoToS(ऐप्लिकेशन ऐप्लिकेशन, NavigationApi.NavigatorListener कॉलबैक) Navigator इंस्टेंस लेता है.
स्टैटिक RoadSnappedLocationProvider	getRoadSnappedLocationProvider(ऐप्लिकेशन ऐप्लिकेशन) RoadSnappedLocationProvider का इंस्टेंस लेता है, जिसका इस्तेमाल रोड से स्नैप की गई उपयोगकर्ता जगहों की सदस्यता लेने के लिए किया जा सकता है.
स्टैटिक NavigationTransactionRecorder	getTransactionRecorder(ऐप्लिकेशन के लिए ऐप्लिकेशन) NavigationTransactionRecorder का इंस्टेंस लेता है, जिसका इस्तेमाल नेविगेशन से जुड़े लेन-देन को रिकॉर्ड करने के लिए किया जा सकता है.
सिंक किया गया स्टैटिक void	initForegroundServiceManager(ऐप्लिकेशन ऐप्लिकेशन, Integer notificationId, स्ट्रिंग defaultMessage, NotificationContentProvider प्रोवाइडर) दिए गए तर्कों के साथ ForegroundServiceManager इंस्टेंस शुरू करता है.
स्टैटिक शून्य	resetTermsAccepted(ऐप्लिकेशन का आवेदन) नियम और शर्तें रीसेट करें - जांच के लिए.
स्टैटिक शून्य	showTermsAndConditionsDialog(गतिविधि गतिविधि, String companyName, स्ट्रिंग टाइटल, NavigationApi.OnTermsResponseListener) यह एक डायलॉग दिखाता है, जो उपयोगकर्ता को डिफ़ॉल्ट लुक और स्टाइल का इस्तेमाल करके, Google के नेविगेशन के नियम और शर्तों को स्वीकार करने के लिए कहता है.
स्टैटिक शून्य	showTermsAndConditionsDialog(गतिविधि गतिविधि, स्ट्रिंग कंपनी का नाम, स्ट्रिंग का टाइटल, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener, लिसनर, TermsAndConditionsCheckOption termsAndConditionsCheckOption) एक डायलॉग दिखाता है, जो उपयोगकर्ता को Google के नेविगेशन के नियम और शर्तें स्वीकार करने का निर्देश देता है.
स्टैटिक शून्य	showTermsAndConditionsDialog(गतिविधि गतिविधि, String companyName, NavigationApi.OnTermsResponseListener लिसनर) यह एक डायलॉग दिखाता है, जो उपयोगकर्ता को डिफ़ॉल्ट शीर्षक और डिफ़ॉल्ट लुक और स्टाइल का इस्तेमाल करके, Google के नेविगेशन से जुड़े नियमों और शर्तों को स्वीकार करने के लिए कहता है.

इनहेरिट किए गए तरीके की खास जानकारी

java.lang.Object क्लास से

boolean	इसके बराबर है(ऑब्जेक्ट आर्ग्युमेंट0)
फ़ाइनल क्लास<?>	getClass()
int	hashCode()
फ़ाइनल शून्य	notify()
फ़ाइनल शून्य	notifyAll()
String	toString()
फ़ाइनल शून्य	wait(long org0, int arch1)
फ़ाइनल शून्य	wait(long org0)
फ़ाइनल शून्य	wait()

सार्वजनिक तरीके

सार्वजनिक स्थिर बूलियन areTermsAccepted (ऐप्लिकेशन ऐप्लिकेशन)

अगर उपयोगकर्ता ने पहले Google नेविगेशन के नियमों और शर्तों को स्वीकार किया है, तो true दिखाता है.

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

पैरामीटर

ऐप्लिकेशन	मौजूदा ऐप्लिकेशन

रिटर्न

• true, अगर उपयोगकर्ता ने शर्तें स्वीकार कर ली हैं, तो false

सार्वजनिक स्टैटिक शून्य क्लीनअप ()

NavSDK के कॉम्पोनेंट की अंदरूनी स्थिति को साफ़ करता है. अगर मौजूदा नेविगेटर मौजूद है, तो दिशा-निर्देश को बंद और बंद कर दिया गया है. इस नेविगेटर से भविष्य में मार्गदर्शन के लिए कोई कॉल नहीं किया जा सकता. जब आपके ऐप्लिकेशन को नेविगेटर की ज़रूरत न हो और आपके ऐप्लिकेशन ने नेविगेटर के सभी रेफ़रंस मिटा दिए हों, तब मेमोरी वापस पाने के लिए, इस तरीके को कॉल करें. अगर इस कॉल के बाद, आपके ऐप्लिकेशन को नेविगेटर की ज़रूरत होती है, तो getNavigator() का इस्तेमाल करके, नया नेविगेटर बनाएं. ध्यान दें: नया नेविगेटर बनाने में समय लगता है. इस बात पर ध्यान दें कि देरी से, आपके ऐप्लिकेशन की परफ़ॉर्मेंस पर क्या असर पड़ेगा और मेमोरी वापस मिलने के फ़ायदों पर क्या असर पड़ेगा.

सार्वजनिक स्टैटिक सिंक की गई ForegroundServiceManager getForegroundServiceManager (ऐप्लिकेशन ऐप्लिकेशन)

सिंगलटन ForegroundServiceManager इंस्टेंस हासिल करता है. अगर initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) को getForegroundServiceManager(Application) से पहले कॉल नहीं किया जाता, तो सूचना आईडी, मैसेज, और सूचना देने वाली कंपनी के डिफ़ॉल्ट आईडी का इस्तेमाल किया जाएगा.

पैरामीटर

ऐप्लिकेशन	मौजूदा Application

सार्वजनिक स्टैटिक स्ट्रिंग getNavSDKVersion ()

NavSDK का मौजूदा वर्शन दिखाता है.

सार्वजनिक स्टैटिक शून्य getNavigator (ऐप्लिकेशन ऐप्लिकेशन, NavigationApi.NavigatorListener कॉलबैक)

Navigator इंस्टेंस लेता है.

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

ध्यान दें कि नेविगेटर एक सिंगलटन है. अगर इस तरीके को कई बार कॉल किया जाता है, तो हर कॉल एक ही नेविगेटर दिखाएगा.

पैरामीटर

ऐप्लिकेशन	मौजूदा Application
कॉलबैक	एक कॉलबैक, जो Navigator के तैयार होने या कोई गड़बड़ी होने पर ट्रिगर होगा

सार्वजनिक स्टैटिक शून्य getNavigator (गतिविधि गतिविधि, NavigationApi.NavigatorListener कॉलबैक, TermsAndConditionsCheckOption शर्त की जांच)

Navigator इंस्टेंस लेता है.

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

अगर termsCheck की वैल्यू ENABLED है, तो इस डायलॉग में नेविगेशन SDK टूल के नियमों और शर्तों का लिंक भी शामिल होगा. अगर उपयोगकर्ता इन शर्तों को स्वीकार नहीं कर पाता है, तो callback को TERMS_NOT_ACCEPTED गड़बड़ी के साथ कॉल किया जाएगा.

ध्यान दें कि नेविगेटर एक सिंगलटन है. अगर इस तरीके को कई बार कॉल किया जाता है, तो हर कॉल एक ही नेविगेटर दिखाएगा.

पैरामीटर

गतिविधि	नियम और शर्तों वाला डायलॉग बॉक्स दिखाने के लिए, Activity पर जाएं. हालांकि, ऐसा तब होगा, जब उन्हें स्वीकार नहीं किया गया हो
कॉलबैक	एक कॉलबैक, जो Navigator के तैयार होने या कोई गड़बड़ी होने पर ट्रिगर होगा
termsCheck	यह बताता है कि नियम और शर्तों की जांच को स्किप करना है या नहीं

सार्वजनिक स्टैटिक शून्य getNavigator (गतिविधि गतिविधि, NavigationApi.NavigatorListener कॉलबैक)

getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED} के बराबर.

पैरामीटर

गतिविधि
कॉलबैक

यह भी देखें

• getNavigator(Activity, NavigatorListener, TermsAndConditionsCheckOption)

सार्वजनिक स्टैटिक शून्य getNavigatorNoToS (ऐप्लिकेशन ऐप्लिकेशन, NavigationApi.NavigatorListener कॉलबैक)

Navigator इंस्टेंस लेता है.

नियम और शर्तों को बायपास करता है.

ध्यान दें कि नेविगेटर एक सिंगलटन है. अगर इस तरीके को कई बार कॉल किया जाता है, तो हर कॉल एक ही नेविगेटर दिखाएगा.

पैरामीटर

ऐप्लिकेशन	मौजूदा Application.
कॉलबैक	एक कॉलबैक, जो Navigator के तैयार होने या कोई गड़बड़ी होने पर ट्रिगर होगा.

सार्वजनिक स्टैटिक RoadSnappedLocationProvider getRoadSnappedLocationProvider (ऐप्लिकेशन ऐप्लिकेशन)

RoadSnappedLocationProvider का इंस्टेंस लेता है, जिसका इस्तेमाल रोड से स्नैप की गई उपयोगकर्ता जगहों की सदस्यता लेने के लिए किया जा सकता है. ध्यान दें कि अगर आप सड़क से स्नैप किए गए जगह की जानकारी के अपडेट की सदस्यता लेते हैं, तो हो सकता है कि डिवाइस की बैटरी तेज़ी से खर्च हो या उपयोगकर्ता की जगह की जानकारी का डेटा अनजाने में इकट्ठा हो जाए. ऐसा, बैकग्राउंड में चलते रहने पर होता है.

इस तरीके को कॉल करने से पहले Navigator को हासिल करना ज़रूरी है. ऐसा न करने पर, यह null दिखाएगा.

पैरामीटर

ऐप्लिकेशन	मौजूदा Application

सार्वजनिक स्टैटिक NavigationTransactionRecorder getTransactionRecorder (ऐप्लिकेशन ऐप्लिकेशन)

NavigationTransactionRecorder का इंस्टेंस लेता है, जिसका इस्तेमाल नेविगेशन से जुड़े लेन-देन को रिकॉर्ड करने के लिए किया जा सकता है.

इस क्लास का इस्तेमाल सिर्फ़ तब करना चाहिए, जब Google ने हर ट्रांज़ैक्शन के आधार पर आपकी कंपनी की बिलिंग की हो.

इस तरीके को कॉल करने से पहले Navigator को हासिल करना ज़रूरी है. ऐसा न करने पर, यह null दिखाएगा.

पैरामीटर

ऐप्लिकेशन	मौजूदा Application

सार्वजनिक स्टैटिक सिंक की गई void initForegroundServiceManager (ऐप्लिकेशन ऐप्लिकेशन, Integer notificationId, स्ट्रिंग defaultMessage, NotificationContentProvider कंपनी)

दिए गए तर्कों के साथ ForegroundServiceManager इंस्टेंस शुरू करता है.

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

पैरामीटर

ऐप्लिकेशन	मौजूदा Application
notificationId	लगातार मिलने वाली सूचना का सूचना आईडी
defaultMessage	अगर provider तय नहीं किया गया है, तो डिफ़ॉल्ट मैसेज दिखाया जाएगा
कंपनी	NotificationContentProvider को लागू करना

Public स्टैटिक void resetTermsAccepted (ऐप्लिकेशन ऐप्लिकेशन)

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

पैरामीटर

ऐप्लिकेशन	मौजूदा ऐप्लिकेशन

सार्वजनिक स्टैटिक शून्य showTermsAndConditionsDialog (गतिविधि गतिविधि, स्ट्रिंग कंपनी का नाम, स्ट्रिंग का टाइटल, NavigationApi.OnTermsResponseListener लिसनर)

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

पैरामीटर

गतिविधि
companyName
टाइटल
लिसनर

यह भी देखें

• for a description of the different parameters.

showTermsAndConditionsDialogTermsAndConditionsUIParamsNavigationApi.OnTermsResponseListenerTermsAndConditionsCheckOption

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

ध्यान दें कि अगर उपयोगकर्ता ने पहले से ही न्योता स्वीकार कर लिया है, तब भी डायलॉग दिखेगा. इसे सिर्फ़ तब कॉल किया जाना चाहिए, जब areTermsAccepted(Application) false हो, क्योंकि हो सकता है कि कोई उपयोगकर्ता नियमों और शर्तों को स्वीकार न करे.

पैरामीटर

गतिविधि	वह Activity जिस पर डायलॉग दिखाया जाएगा
companyName	आपकी कंपनी का नाम, जो नियम और शर्तों वाले डायलॉग में दिखेगा
टाइटल	डायलॉग का शीर्षक. शून्य होने पर, डायलॉग बॉक्स डिफ़ॉल्ट टाइटल का इस्तेमाल करेगा.
uiParams	डायलॉग के लुक और स्टाइल को पसंद के मुताबिक बनाने में इस्तेमाल किए गए पैरामीटर. शून्य होने पर, डिफ़ॉल्ट लुक और स्टाइल का इस्तेमाल किया जाता है.
लिसनर	एक वैकल्पिक कॉलबैक, जो तब ट्रिगर होगा, जब उपयोगकर्ता नियमों और शर्तों को स्वीकार या अस्वीकार करेगा
termsAndConditionsCheckOption	TermsAndConditionsCheckOption, जो नियम और शर्तों की जांच करने के विकल्प बताता है

सार्वजनिक स्टैटिक शून्य showTermsAndConditionsDialog (गतिविधि गतिविधि, String companyName, NavigationApi.OnTermsResponseListener लिसनर)

यह एक डायलॉग दिखाता है, जो उपयोगकर्ता को डिफ़ॉल्ट शीर्षक और डिफ़ॉल्ट लुक और स्टाइल का इस्तेमाल करके, Google के नेविगेशन से जुड़े नियमों और शर्तों को स्वीकार करने के लिए कहता है.

पैरामीटर

गतिविधि
companyName
लिसनर

यह भी देखें

• for a description of the different parameters.