डेमो आज़माएं

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

तैयार हो जाएं

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

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

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

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

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

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

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

GoogleNavigation का डेमो

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

इमारत

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

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

      MAPS_API_KEY=YOUR_API_KEY

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

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

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

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

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

दौड़ना

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

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

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

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

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

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

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

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

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

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

SwappingMapAndNavActivity विकल्प

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

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

Google Maps का डेमो

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

इमारत

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

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

      MAPS_API_KEY=YOUR_API_KEY

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

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

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

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

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

दौड़ना

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

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

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

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

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

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