डेमो आज़माएं

Android के लिए Navigation SDK टूल को इंटिग्रेट करके, आपका ऐप्लिकेशन बाहरी मैप व्यू से लिंक करने के अलावा और भी काम कर सकता है. Google Maps नेविगेशन की मदद से, आपका ऐप्लिकेशन किसी उपयोगकर्ता की यात्रा के बारे में डेटा को डाइनैमिक तरीके से फिर से हासिल कर सकता है. साथ ही, एक ही नज़र में रिपोर्टिंग की सुविधा दे सकता है. इस गाइड में, Navigation SDK के डेमो ऐप्लिकेशन चलाने का तरीका बताया गया है. ये ऐप्लिकेशन GitHub पर उपलब्ध हैं.

तैयार हो जाएं

Navigation SDK का इस्तेमाल शुरू करने के लिए, आपके पास ये चीज़ें होनी चाहिए.

• Navigation SDK के साथ इस्तेमाल करने के लिए उपलब्ध कराया गया एपीआई पासकोड. कुंजियां बनाने और उन पर पाबंदियां लगाने के बारे में ज़्यादा जानने के लिए, एपीआई कुंजियों का इस्तेमाल करना लेख पढ़ें.
• एसडीके का आर्टफ़ैक्ट. पुष्टि करें कि Navigation SDK के लिए Maven का इस्तेमाल करने के लिए, आपका प्रोजेक्ट कॉन्फ़िगर किया गया हो.
• एक या उससे ज़्यादा डेमो ऐप्लिकेशन.
• Android Studio, Navigation SDK की मदद से ऐप्लिकेशन बनाने के लिए, सुझाया गया डेवलपमेंट एनवायरमेंट है.

यह दस्तावेज़ उन लोगों के लिए बनाया गया है जिन्हें Android डेवलपमेंट और ऑब्जेक्ट-ओरिएंटेड प्रोग्रामिंग के कॉन्सेप्ट के बारे में जानकारी है. आपको Google Maps के बारे में उपयोगकर्ता के नज़रिए से भी जानकारी होनी चाहिए.

ध्यान दें: अगर आपका ऐप्लिकेशन पहले से ही Maps SDK का इस्तेमाल करता है, तो मैप लेयर और नेविगेशन, दोनों सुविधाओं के लिए Navigation SDK, Maps SDK की जगह ले लेता है. एक ही ऐप्लिकेशन में Navigation SDK और Maps SDK का इस्तेमाल नहीं किया जा सकता.

डेमो ऐप्लिकेशन पाना

Google, दो ऐप्लिकेशन उपलब्ध कराता है. इनकी मदद से, यह समझा जा सकता है कि Google Maps API के अलावा, Navigation SDK में कौन-कौनसी सुविधाएं उपलब्ध हैं. हालांकि, यह इस बात पर निर्भर करता है कि आपको कितना अनुभव है. Google Maps API के बारे में जानने वाले डेवलपर, GoogleNavigation के डेमो पर ध्यान दे सकते हैं. दोनों प्रोजेक्ट में नए डेवलपर को ये दोनों ऐप्लिकेशन मददगार लगेंगे.

Android के लिए Navigation SDK v4.1 के मुताबिक, यहां दिए गए दोनों डेमो ऐप्लिकेशन, डाउनलोड करने के लिए GitHub पर उपलब्ध हैं.

• GoogleNavigation डेमो: इसमें एपीआई के व्यवहार और व्यू के इंटिग्रेशन को दिखाया गया है. ये इंटिग्रेशन, निर्देशित नेविगेशन सेशन के दौरान उपयोगकर्ता के अनुभव से जुड़े होते हैं.

• GoogleMap डेमो: इसमें GoogleMap इंटरफ़ेस के अलग-अलग व्यवहारों को दिखाया गया है. इससे मैप के लुक और प्रज़ेंटेशन को पसंद के मुताबिक बनाया जा सकता है.

GoogleNavigation डेमो

GoogleNavigation का नया डेमो GitHub पर उपलब्ध है.

बनाएं

1. Android Studio में, डेमो ऐप्लिकेशन इंपोर्ट करें और Gradle को चलाने की अनुमति दें.

   ध्यान दें: जब तक local.defaults.properties को उपलब्ध कराई गई एपीआई कुंजी से अपडेट नहीं किया जाता, तब तक ऐप्लिकेशन मैप लोड नहीं कर पाता.

2. local.defaults.properties खोलें और MAPS_API_KEY प्रॉपर्टी की वैल्यू अपडेट करें:

     MAPS_API_KEY=YOUR_API_KEY
   

3. build पर क्लिक करें और एसडीके लागू करने की जानकारी देखें.

   • Java क्लास में, कोड लागू करने का तरीका नोट करें.

   • लेआउट एक्सएमएल में, लेआउट डिज़ाइन और टेक्स्ट देखें.

   • build.gradle फ़ाइल में, डिपेंडेंसी में मौजूद एसडीके को नोट करें.

एपीआई पासकोड को मेनिफ़ेस्ट में कैसे जोड़ा जाता है, इस बारे में ज़्यादा जानने के लिए, Secrets Gradle plugin का दस्तावेज़ देखें.

चलाएं

1. Android डिवाइस को अपने कंप्यूटर से कनेक्ट करें या एम्युलेटर का इस्तेमाल करें.

   • Android डिवाइस—अपने Android डिवाइस पर डेवलपर के लिए सेटिंग और टूल के विकल्प चालू करने और डिवाइस का पता लगाने के लिए अपने सिस्टम को कॉन्फ़िगर करने के लिए, निर्देश देखें.
   • एम्युलेटर—वर्चुअल डिवाइस को कॉन्फ़िगर करने के लिए, Android वर्चुअल डिवाइस (AVD) मैनेजर का इस्तेमाल करें. एम्युलेटर चुनते समय, पक्का करें कि आपने ऐसी इमेज चुनी हो जिसमें Google API शामिल हों.

2. Android Studio में, Run मेन्यू विकल्प (या प्ले बटन आइकॉन) पर क्लिक करें. इसके बाद, डिप्लॉयमेंट का टारगेट चुनें.

बनाए जाने और लॉन्च किए जाने के बाद, ऐप्लिकेशन उपयोगकर्ता को विकल्पों की सूची वाला लैंडिंग पेज दिखाता है.

NavViewActivity और NavFragmentActivity के विकल्प

NavSDK का इस्तेमाल करने वाले नए डेवलपर को ये दो विकल्प सबसे ज़्यादा काम के लग सकते हैं.

पहला विकल्प: NavViewActivity, Navigator के साथ-साथ NavigationView का इस्तेमाल करके व्यवहार दिखाता है.

दूसरा विकल्प: दूसरे विकल्प का नाम NavFragmentActivity है. इसमें Navigator के साथ-साथ SupportNavigationFragment का इस्तेमाल करके, व्यवहारों को दिखाया गया है.

ध्यान दें: ज़्यादातर मामलों में, हमारा सुझाव है कि NavigationView के साथ सीधे इंटरैक्ट करने के बजाय, SupportNavigationFragment का इस्तेमाल करें. यह NavigationView के लिए रैपर है. ज़्यादा जानकारी के लिए, नेविगेशन मैप के साथ इंटरैक्ट करने के सबसे सही तरीके देखें.

इनमें से किसी एक विकल्प पर क्लिक करने पर, आपको ये चीज़ें दिखेंगी:

• नेविगेशन यूज़र इंटरफ़ेस (यूआई)
• ऐप्लिकेशन के मेन्यू में "मंज़िल सेट करें" बटन
• एक ओवरले, जिसके साथ इंटरैक्ट करके एपीआई पर तरीकों को डाइनैमिक तरीके से लागू किया जा सकता है
• ज़्यादा विकल्पों वाला ओवरफ़्लो मेन्यू

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

SwappingMapAndNavActivity विकल्प

ध्यान दें: इस विकल्प की मदद से, v1 से v4 पर आसानी से स्विच किया जा सकता है. हमारा सुझाव है कि जहां भी मुमकिन हो वहां सिर्फ़ NavigationView का इस्तेमाल करें. हालांकि, हमने यहां एक उदाहरण दिया है, ताकि आपको पता चल सके कि दोनों का एक साथ इस्तेमाल कैसे किया जा सकता है.

SwappingMapAndNavActivity में, ये सामान्य पैटर्न दिखाए गए हैं:

• MapView दिखाया जा रहा है
• नेविगेशन शुरू होने पर, NavigationView पर स्विच करना
• नेविगेशन खत्म होने पर, MapView पर वापस जाना

GoogleMap का डेमो

GoogleNavigation का नया डेमो GitHub पर उपलब्ध है.

ध्यान दें: अपने ऐप्लिकेशन में GoogleMap ऑब्जेक्ट के साथ इंटरैक्ट करने के बारे में ज़्यादा जानने के लिए, GoogleMap के साथ इंटरैक्ट करने के सबसे सही तरीके देखें.

बनाएं

1. Android Studio में, डेमो ऐप्लिकेशन इंपोर्ट करें और Gradle को चलाने की अनुमति दें.

   ध्यान दें: जब तक आपने local.defaults.properties फ़ाइल में, उपलब्ध कराई गई एपीआई पासकोड की जानकारी अपडेट नहीं की है, तब तक ऐप्लिकेशन मैप लोड नहीं कर पाएगा.

2. local.defaults.properties खोलें और MAPS_API_KEY प्रॉपर्टी की वैल्यू अपडेट करें:

     MAPS_API_KEY=YOUR_API_KEY
   

3. build पर क्लिक करें और एसडीके लागू करने की जानकारी देखें.

   • Java क्लास में, कोड लागू करने का तरीका नोट करें.

   • लेआउट एक्सएमएल में, लेआउट डिज़ाइन और टेक्स्ट देखें.

   • build.gradle फ़ाइल में, डिपेंडेंसी में मौजूद एसडीके को नोट करें.

एपीआई पासकोड को मेनिफ़ेस्ट में जोड़ने के तरीके के बारे में ज़्यादा जानने के लिए, secrets gradle plugin देखें.

चलाएं

1. Android डिवाइस को अपने कंप्यूटर से कनेक्ट करें या एम्युलेटर का इस्तेमाल करें.

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

2. Android Studio में, Run मेन्यू विकल्प (या प्ले बटन आइकॉन) पर क्लिक करें. इसके बाद, डिप्लॉयमेंट का टारगेट चुनें.

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

यह प्रज़ेंटेशन पैटर्न और सोर्स कोड का इससे जुड़ा स्ट्रक्चर, Google Maps SDK के डेमो इस्तेमाल करने वाले लोगों को पता होना चाहिए. ऐसा इसलिए है, क्योंकि GoogleMap डेमो को Maps API डेमो ऐप्लिकेशन की तरह डिज़ाइन किया गया है. मुख्य अंतर यह है कि Navigation SDK डेमो में, उपयोगकर्ता यह चुन सकता है कि उसे किस व्यू क्लास पर डेमो टेस्ट करना है: NavigationView या MapView. हालांकि, यह सुविधा सिर्फ़ उन मामलों में उपलब्ध होती है जहां इसे लागू किया जा सकता है.

Google, आम तौर पर अडॉप्शन करने वालों को NavigationView का इस्तेमाल करने के लिए कहता है. इस डेमो में, हमारे डेमो ऐप्लिकेशन के दोनों वर्शन पर इन तरीकों को आज़माने की सुविधा मिलती है. साथ ही, आपके पास अपनी पसंद का तरीका चुनने का विकल्प होता है. उदाहरण के लिए, ऐसी स्थितियों में अब भी MapView का इस्तेमाल करना ज़रूरी हो सकता है जहां तीसरे पक्ष की ऐसी लाइब्रेरी का इस्तेमाल किया जा रहा हो जो उस क्लास के साथ इंटरैक्ट करती है.

अहम जानकारी: MapView, MapFragment, और SupportMapFragment क्लास के लिए, डिवाइसों पर Google Play services ऐप्लिकेशन इंस्टॉल होना ज़रूरी है. अगर आपने नया एम्युलेटर शुरू किया है या किसी बहुत पुराने डिवाइस को फ़ैक्ट्री रीसेट किया है, तो हो सकता है कि Android इमेज में Google Play services का बहुत पुराना वर्शन पहले से इंस्टॉल हो. ऐसे मामलों में, आपको नए वर्शन के अपने-आप डाउनलोड होने का इंतज़ार करना होगा.