डेमो आज़माएं

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

तैयार हो जाएं

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

• Google Maps Platform प्रतिनिधि:

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

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

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

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

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

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

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

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

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

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

नया Googleनेविगेशन डेमो, GitHub पर उपलब्ध है.

पसंदीदा

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. बिल्ड करें पर क्लिक करें और SDK टूल लागू करने से जुड़ी जानकारी की जांच करें.

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

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

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

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

दौड़ना

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

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

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

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

NavViewActivity और Navफ़्रैगमेंट ऐक्टिविटी के विकल्प

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

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

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

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

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

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

SwippingMapAndNavActivity विकल्प

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

• MapView दिखा रहा है
• नेविगेशन शुरू होने पर, अपने-आप स्क्रोल होने पर NavigationView
• नेविगेशन बंद होने पर, MapView पर वापस लौटता है

Google Maps का डेमो

नया Googleनेविगेशन डेमो, GitHub पर उपलब्ध है.

पसंदीदा

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. बिल्ड करें पर क्लिक करें और SDK टूल लागू करने से जुड़ी जानकारी की जांच करें.

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

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

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

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

दौड़ना

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

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

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

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

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

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