डेमो आज़माएं

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

इस गाइड में आपको Android Studio प्रोजेक्ट की जानकारी और नेविगेशन SDK टूल को इंटिग्रेट करने का तरीका बताया गया है. इसके बाद, डेमो ऐप्लिकेशन को चलाने का तरीका भी बताया गया है.

नेविगेशन SDK टूल एक स्टैटिक लाइब्रेरी है. इसकी मदद से, यह कंट्रोल किया जा सकता है कि ऐप्लिकेशन में नेविगेशन के लिए, ऑडियो कैसा और कैसा है. लाइब्रेरी के बारे में ज़्यादा जानकारी के लिए, एक अलग विंडो में नेविगेशन SDK टूल का रेफ़रंस (Javadoc) खोलें.

तैयार हो जाएं

अहम जानकारी: Android के लिए नेविगेशन SDK के v3.0 वर्शन के हिसाब से, आपको हमारे Maven का डेटा स्टोर करने की जगह से, Android के लिए नेविगेशन SDK का नया वर्शन मिल सकता है. अब यह SDK टूल पाने का पसंदीदा तरीका है. ज़्यादा जानकारी के लिए, अपना प्रोजेक्ट सेट अप करना देखें.

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

नेविगेशन SDK के साथ शुरुआत करने के लिए पक्का करें कि आपके पास ये आइटम हों.

• इन्हें ऐक्सेस करने के लिए Google Maps Platform का प्रतिनिधि:

  • नेविगेशन SDK टूल के साथ इस्तेमाल करने के लिए, एक एपीआई कुंजी का प्रावधान किया गया. आपको अपना प्रोजेक्ट आईडी देना होगा. इसे Google Cloud Console के मुख्य डैशबोर्ड में प्रोजेक्ट के नाम के नीचे देखा जा सकता है.
  • SDK आर्टफ़ैक्ट. पक्का करें कि आपका प्रोजेक्ट कॉन्फ़िगर है, ताकि नेविगेशन SDK टूल के लिए Maven का इस्तेमाल किया जा सके.
  • v4.99.0 और इससे पहले के वर्शन का इस्तेमाल करने वाले प्रोजेक्ट के लिए. अगर Maven का इस्तेमाल नहीं किया जा सकता, तो शेयर की गई Google Drive से ज़िप किया गया आर्टफ़ैक्ट डाउनलोड किया जा सकता है. स्टैटिक लाइब्रेरी फ़ाइल libs/ डायरेक्ट्री में मौजूद .aar है, जिसमें नेविगेशन SDK टूल AAR बंडल के तौर पर मौजूद है.
  • एक या उससे ज़्यादा डेमो ऐप्लिकेशन.

• Android Studio, नेविगेशन SDK टूल वाला ऐप्लिकेशन बनाने के लिए सुझाया गया डेवलपमेंट एनवायरमेंट.

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

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

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

Android v4.1 के लिए नेविगेशन SDK टूल के हिसाब से, नीचे दिए गए डेमो ऐप्लिकेशन शेयर किए गए Google Drive में उपलब्ध हैं, ताकि इन्हें डाउनलोड किया जा सके.

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

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

Maven के इस्तेमाल के बारे में जानकारी

डेमो ऐप्लिकेशन को रिमोट Maven रिपॉज़िटरी से SDK आर्टफ़ैक्ट डाउनलोड करने के लिए कॉन्फ़िगर किया गया है. इसके लिए, Gradle में Artifact Registry प्लगिन का इस्तेमाल करना होगा. SDK टूल का ऐक्सेस पाने के लिए, प्रोजेक्ट कॉन्फ़िगरेशन के निर्देशों का पालन ज़रूर करें.

ध्यान दें: 4.99.0 और इससे पहले के वर्शन में, अगर आपको अब भी अपने प्रोजेक्ट में प्रोसेस नहीं किया गया AAR बंडल इस्तेमाल करना है, तो libs डायरेक्ट्री में जाकर, उसे अपने प्रोजेक्ट में जोड़ा जा सकता है. इसके बाद, आपको artifactregistry प्लगिन और रिमोट रिपॉज़िटरी के सभी रेफ़रंस हटाने होंगे. साथ ही, अपने ऐप्लिकेशन-लेवल build.gradle में ये AAR डिपेंडेंसी का एलान करना होगा: api(name: 'google_navigation', ext: 'aar')

Googleनेविगेशन डेमो

नया Googleनेविगेशन डेमो, शेयर की गई Google Drive के रूट में उपलब्ध है. ऐप के पिछले वर्शन "संग्रह" में मौजूद होते हैं. वर्शन 4.1 से पहले के वर्शन में, ऐप्लिकेशन को एक ही ZIP फ़ाइल में AAR के साथ बंडल किया जाता है.

पसंदीदा

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

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. build पर क्लिक करें और SDK टूल लागू करने की जानकारी की जांच करें.

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

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

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

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

दौड़ना

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

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

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

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

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

NavSDK टूल को अपनाने वाले नए लोगों को ये दो विकल्प सबसे ज़्यादा काम के लगेंगे.

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

दूसरा विकल्प: NavFragmentActivity टाइटल वाले दूसरे विकल्प में, Navigator के साथ SupportNavigationFragment का इस्तेमाल करके व्यवहार के बारे में बताया जाता है.

इनमें से किसी भी विकल्प पर क्लिक करने पर, आपको यह जानकारी दिखेगी:

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

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

SppingMapAndNavActivity का विकल्प

ध्यान दें: यह विकल्प v1 से v4 में ट्रांज़िशन करने में आपकी मदद करेगा. हमारी सलाह है कि जहां भी मुमकिन हो, खास तौर पर NavigationView का इस्तेमाल करें. हालांकि, इसे उदाहरण के तौर पर, दोनों को साथ-साथ इस्तेमाल करने के तरीके के तौर पर दिया गया है.

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

• MapView दिखाया जा रहा है
• नेविगेशन शुरू होने पर, इसे NavigationView में बदलना
• नेविगेशन खत्म होने पर, MapView पर वापस लौटना

GoogleMaps डेमो

ध्यान दें: यह ऐप्लिकेशन, SDK टूल के वर्शन 4.1 से पहले के वर्शन के लिए उपलब्ध नहीं है.

नया Googleनेविगेशन डेमो, शेयर किए गए Google Drive के रूट में उपलब्ध है. ऐप के पिछले वर्शन "संग्रह" में मौजूद होते हैं.

पसंदीदा

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

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. build पर क्लिक करें और SDK टूल लागू करने की जानकारी की जांच करें.

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

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

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

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

दौड़ना

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

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

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

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

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

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

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