नेविगेशन एपीआई की एंट्री पॉइंट. 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 के नेविगेशन से जुड़े नियमों और शर्तों को स्वीकार करने के लिए कहता है.
|
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
सार्वजनिक स्थिर बूलियन 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
गड़बड़ी के साथ कॉल किया
जाएगा.
ध्यान दें कि नेविगेटर एक सिंगलटन है. अगर इस तरीके को कई बार कॉल किया जाता है, तो हर कॉल एक ही नेविगेटर दिखाएगा.
सार्वजनिक स्टैटिक शून्य getNavigator (गतिविधि गतिविधि, NavigationApi.NavigatorListener कॉलबैक)
getNavigator(activity, callback, {@link
TermsAndConditionsCheckOption#ENABLED}
के बराबर.
पैरामीटर
गतिविधि | |
---|---|
कॉलबैक |
सार्वजनिक स्टैटिक शून्य 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 | |
टाइटल | |
लिसनर |
यह भी देखें
showTermsAndConditionsDialogTermsAndConditionsUIParamsNavigationApi.OnTermsResponseListenerTermsAndConditionsCheckOption
एक डायलॉग दिखाता है, जो उपयोगकर्ता को Google के नेविगेशन के नियम और शर्तें स्वीकार करने का निर्देश देता है. अगर बताया गया है, तो लिसनर को यूज़र इंटरफ़ेस (यूआई) थ्रेड पर कॉल किया जाएगा. इससे यह पता चलेगा कि उपयोगकर्ता, नियमों और शर्तों को स्वीकार करता है या नहीं.
ध्यान दें कि अगर उपयोगकर्ता ने पहले से ही न्योता स्वीकार कर लिया है, तब भी डायलॉग दिखेगा. इसे सिर्फ़ तब
कॉल किया जाना चाहिए, जब areTermsAccepted(Application)
false
हो, क्योंकि हो सकता है कि
कोई उपयोगकर्ता नियमों और शर्तों को स्वीकार न करे.
पैरामीटर
गतिविधि | वह Activity जिस पर डायलॉग दिखाया जाएगा |
---|---|
companyName | आपकी कंपनी का नाम, जो नियम और शर्तों वाले डायलॉग में दिखेगा |
टाइटल | डायलॉग का शीर्षक. शून्य होने पर, डायलॉग बॉक्स डिफ़ॉल्ट टाइटल का इस्तेमाल करेगा. |
uiParams | डायलॉग के लुक और स्टाइल को पसंद के मुताबिक बनाने में इस्तेमाल किए गए पैरामीटर. शून्य होने पर, डिफ़ॉल्ट लुक और स्टाइल का इस्तेमाल किया जाता है. |
लिसनर | एक वैकल्पिक कॉलबैक, जो तब ट्रिगर होगा, जब उपयोगकर्ता नियमों और शर्तों को स्वीकार या अस्वीकार करेगा |
termsAndConditionsCheckOption | TermsAndConditionsCheckOption , जो नियम और शर्तों की जांच करने के विकल्प बताता है
|
सार्वजनिक स्टैटिक शून्य showTermsAndConditionsDialog (गतिविधि गतिविधि, String companyName, NavigationApi.OnTermsResponseListener लिसनर)
यह एक डायलॉग दिखाता है, जो उपयोगकर्ता को डिफ़ॉल्ट शीर्षक और डिफ़ॉल्ट लुक और स्टाइल का इस्तेमाल करके, Google के नेविगेशन से जुड़े नियमों और शर्तों को स्वीकार करने के लिए कहता है.
पैरामीटर
गतिविधि | |
---|---|
companyName | |
लिसनर |