Android के लिए नेविगेशन SDK टूल को इंटिग्रेट करके, आपके ऐप्लिकेशन को किसी बाहरी मैप व्यू से लिंक करने के अलावा और भी काम किए जा सकते हैं. Google Maps नेविगेशन की मदद से, आपका ऐप्लिकेशन उपयोगकर्ता की यात्रा के डेटा को डाइनैमिक तरीके से रीट्रिव कर सकता है. साथ ही, एक नज़र में रिपोर्टिंग भी कर सकता है. इस गाइड में, GitHub पर उपलब्ध Navigation SDK टूल के डेमो ऐप्लिकेशन चलाने का तरीका बताया गया है.
तैयार हो जाएं
Navigation SDK टूल का इस्तेमाल शुरू करने के लिए, आपके पास ये चीज़ें होनी चाहिए.
- नेविगेशन SDK के साथ इस्तेमाल करने के लिए उपलब्ध कराई गई एपीआई पासकोड. कुंजियां बनाने और उन पर पाबंदी लगाने के बारे में ज़्यादा जानने के लिए, एपीआई कुंजियों का इस्तेमाल करना लेख पढ़ें.
- SDK टूल का आर्टफ़ैक्ट. पक्का करें कि आपके प्रोजेक्ट को कॉन्फ़िगर किया गया हो, ताकि नेविगेशन SDK टूल के लिए Maven का इस्तेमाल किया जा सके.
- एक या उससे ज़्यादा डेमो ऐप्लिकेशन.
- Android Studio, Navigation SDK टूल की मदद से ऐप्लिकेशन बनाने के लिए, सुझाया गया डेवलपमेंट एनवायरमेंट.
यह दस्तावेज़, Android डेवलपमेंट और ऑब्जेक्ट-ओरिएंटेड प्रोग्रामिंग के कॉन्सेप्ट के बारे में जानने वाले लोगों के लिए बनाया गया है. आपको उपयोगकर्ता के नज़रिए से भी Google Maps के बारे में जानकारी होनी चाहिए.
डेमो ऐप्लिकेशन पाना
Google दो ऐप्लिकेशन उपलब्ध कराता है, ताकि आपको यह समझने में मदद मिल सके कि Google Maps के एपीआई के साथ-साथ, नेविगेशन SDK टूल क्या-क्या ऑफ़र करता है. यह ऐप्लिकेशन, आपके अनुभव के लेवल के हिसाब से उपलब्ध होते हैं. Google Maps API के बारे में जानने वाले डेवलपर, GoogleNavigation के डेमो पर ध्यान दे सकते हैं. दोनों प्रोजेक्ट के लिए नए डेवलपर, दोनों ऐप्लिकेशन का इस्तेमाल कर सकते हैं.
Android के लिए नेविगेशन SDK टूल के v4.1 वर्शन के बाद, यहां दिए गए दोनों डेमो ऐप्लिकेशन, GitHub पर डाउनलोड किए जा सकते हैं.
GoogleNavigation का डेमो: इसमें एपीआई के व्यवहार और व्यू के इंटिग्रेशन को दिखाया गया है. ये निर्देशों के साथ नेविगेट करने वाले सेशन के दौरान, उपयोगकर्ता के अनुभव से जुड़े होते हैं.
GoogleMap का डेमो: इसमें
GoogleMapइंटरफ़ेस के अलग-अलग व्यवहार दिखाए गए हैं. इससे, मैप के अनुभव और प्रज़ेंटेशन को पसंद के मुताबिक बनाया जा सकता है.
GoogleNavigation का डेमो
GoogleNavigation का नया डेमो, GitHub पर उपलब्ध है.
इमारत
Android Studio में, डेमो ऐप्लिकेशन इंपोर्ट करें और Gradle को चलने की अनुमति दें.
local.defaults.propertiesखोलें औरMAPS_API_KEYप्रॉपर्टी की वैल्यू अपडेट करें:MAPS_API_KEY=YOUR_API_KEYबिल्ड करें पर क्लिक करें और एसडीके टूल लागू करने की जानकारी देखें.
Java क्लास में, लागू करने का कोड नोट करें.
लेआउट एक्सएमएल में, लेआउट डिज़ाइन और टेक्स्ट पर ध्यान दें.
build.gradleफ़ाइल में, डिपेंडेंसी में SDK टूल को नोट करें.
एपीआई पासकोड को मेनिफ़ेस्ट में जोड़ने के तरीके के बारे में ज़्यादा जानने के लिए, Secrets Gradle प्लग इन दस्तावेज़ देखें.
दौड़ना
अपने कंप्यूटर से कोई Android डिवाइस कनेक्ट करें या किसी एमुलेटर का इस्तेमाल करें.
- Android डिवाइस—अपने Android डिवाइस पर, डेवलपर के लिए सेटिंग और टूल के विकल्प चालू करने के लिए, निर्देशों को पढ़ें. साथ ही, डिवाइस का पता लगाने के लिए, अपने सिस्टम को कॉन्फ़िगर करें.
- एम्युलेटरmdash;वर्चुअल डिवाइस को कॉन्फ़िगर करने के लिए, Android वर्चुअल डिवाइस (AVD) मैनेजर का इस्तेमाल करें. कोई एमुलेटर चुनते समय, पक्का करें कि आपने ऐसी इमेज चुनी हो जिसमें Google API शामिल हों.
Android Studio में, चालू करें मेन्यू विकल्प (या प्ले बटन आइकॉन) पर क्लिक करें. इसके बाद, डिप्लॉयमेंट का टारगेट चुनें.
ऐप्लिकेशन बनाने और लॉन्च करने के बाद, उपयोगकर्ता को विकल्पों की सूची वाला लैंडिंग पेज दिखता है.
NavViewActivity और NavFragmentActivity के विकल्प
NavSDK का इस्तेमाल करने वाले नए लोगों को ये दो विकल्प सबसे ज़्यादा काम के लग सकते हैं.
पहला विकल्प: NavViewActivity, Navigator के साथ NavigationView का इस्तेमाल करके व्यवहार दिखाता है.
दूसरा विकल्प: NavFragmentActivity टाइटल वाला दूसरा विकल्प, Navigator के साथ-साथ SupportNavigationFragment का इस्तेमाल करके व्यवहार दिखाता है.
इनमें से किसी एक विकल्प पर क्लिक करने पर, आपको ये चीज़ें दिखेंगी:
- नेविगेशन यूज़र इंटरफ़ेस (यूआई)
- ऐप्लिकेशन के मेन्यू में "डेस्टिनेशन सेट करें" बटन
- एक ओवरले, जिसकी मदद से एपीआई पर डाइनैमिक तरीके से मेथड को शुरू किया जा सकता है
- ज़्यादा विकल्पों वाला ओवरफ़्लो मेन्यू
शुरू करने के लिए, डेस्टिनेशन सेट करें पर क्लिक करें और कोई पता चुनें. इसके बाद, ऐप्लिकेशन आपकी मौजूदा जगह से उस पते तक की यात्रा की जानकारी दिखाता है. कंट्रोल पैनल ओवरले का इस्तेमाल करके देखें कि एपीआई को कॉल करने पर क्या होता है. उदाहरण के लिए, तरीके देखें पर क्लिक करके, एसडीके टूल को नाइट मोड में चलाकर देखें कि यह कैसा दिखता है.
SwappingMapAndNavActivity विकल्प
SwappingMapAndNavActivity में ये सामान्य पैटर्न दिखते हैं:
MapViewदिखा रहा है- नेविगेशन शुरू होने पर,
NavigationViewपर स्विच करना - नेविगेशन खत्म होने पर,
MapViewपर वापस जाना
Google Maps का डेमो
GoogleNavigation का नया डेमो, GitHub पर उपलब्ध है.
इमारत
Android Studio में, डेमो ऐप्लिकेशन इंपोर्ट करें और Gradle को चलाने की अनुमति दें.
local.defaults.propertiesखोलें औरMAPS_API_KEYप्रॉपर्टी की वैल्यू अपडेट करें:MAPS_API_KEY=YOUR_API_KEYबिल्ड करें पर क्लिक करें और एसडीके टूल लागू करने की जानकारी देखें.
Java क्लास में, लागू करने का कोड नोट करें.
लेआउट एक्सएमएल में, लेआउट डिज़ाइन और टेक्स्ट पर ध्यान दें.
build.gradleफ़ाइल में, डिपेंडेंसी में SDK टूल को नोट करें.
मेनिफ़ेस्ट में एपीआई पासकोड जोड़ने के तरीके के बारे में ज़्यादा जानने के लिए, secrets gradle plugin देखें.
दौड़ना
अपने कंप्यूटर से कोई Android डिवाइस कनेक्ट करें या किसी एमुलेटर का इस्तेमाल करें.
- Android डिवाइस अपने Android डिवाइस पर डेवलपर के विकल्प चालू करने के लिए, निर्देशों को देखें. साथ ही, डिवाइस का पता लगाने के लिए अपने सिस्टम को कॉन्फ़िगर करें.
- एम्युलेटर वर्चुअल डिवाइस को कॉन्फ़िगर करने के लिए, Android वर्चुअल डिवाइस (AVD) मैनेजर का इस्तेमाल करें. कोई एमुलेटर चुनते समय, पक्का करें कि आपने ऐसी इमेज चुनी हो जिसमें Google API शामिल हों.
Android Studio में, चालू करें मेन्यू विकल्प (या प्ले बटन आइकॉन) पर क्लिक करें. इसके बाद, डिप्लॉयमेंट टारगेट चुनें.
ऐप्लिकेशन बनाने और लॉन्च करने के बाद, उपयोगकर्ता को डेमो की सूची वाला लैंडिंग पेज दिखता है.
Google Maps SDK के डेमो का इस्तेमाल करने वाले लोगों को, प्रज़ेंटेशन का यह पैटर्न और सोर्स कोड का स्ट्रक्चर पता होना चाहिए. ऐसा इसलिए है, क्योंकि GoogleMap के डेमो को Maps API के डेमो ऐप्लिकेशन के जैसे डिज़ाइन किया गया है. मुख्य अंतर यह है कि नेविगेशन SDK टूल के डेमो में, उपयोगकर्ता यह चुन सकता है कि उसे किस व्यू क्लास पर डेमो टेस्ट-रन करना है: NavigationView या MapView, जहां लागू हो.
Google आम तौर पर, इस सुविधा को अपनाने वाले लोगों को NavigationView का इस्तेमाल करने का सुझाव देता है.
इस डेमो की मदद से, हमारे डेमो ऐप्लिकेशन के दोनों वर्शन पर इन व्यवहारों को आज़माया जा सकता है. साथ ही, अपने हिसाब से कोई भी वर्शन चुना जा सकता है. उदाहरण के लिए, तीसरे पक्ष की ऐसी लाइब्रेरी का इस्तेमाल करने पर, अब भी MapView का इस्तेमाल करना ज़रूरी हो सकता है जो उस क्लास के साथ इंटरैक्ट करती है.