शुरू करें

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

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

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

तैयार हो जाएं

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

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

    • नेविगेशन SDK टूल के साथ इस्तेमाल करने के लिए, एक एपीआई कुंजी का प्रावधान किया गया. आपको अपना प्रोजेक्ट आईडी देना होगा. इसे Google Cloud Console के मुख्य डैशबोर्ड में प्रोजेक्ट के नाम के नीचे देखा जा सकता है.

    • वह ZIP फ़ाइल, जिसमें ये शामिल हैं:

      • libs/ डायरेक्ट्री में मौजूद स्टैटिक लाइब्रेरी फ़ाइल .aar, जिसमें aar बंडल के तौर पर नेविगेशन SDK टूल मौजूद है.
      • लाइसेंस के लिए टेक्स्ट फ़ाइलें और इस्तेमाल की शर्तों और कानूनी समझौतों के लिंक.
      • Android Studio में नए प्रोजेक्ट के तौर पर इंपोर्ट करने के लिए डेमो ऐप्लिकेशन. Gradle और Maven का इस्तेमाल करके Android Studio में डेमो ऐप्लिकेशन बनाने के लिए ऐप्लिकेशन की फ़ाइलें.

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

SDK टूल, डेमो ऐप्लिकेशन, और दस्तावेज़ पाएं

SDK टूल फ़ाइल को डाउनलोड और अनज़िप करने के बाद, डेमो ऐप्लिकेशन की जांच की जा सकती है और उसे चलाया जा सकता है.

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

  1. अपने पसंदीदा फ़ाइल मैनेजर का इस्तेमाल करके, SDK टूल की फ़ाइलों वाली डायरेक्ट्री पर जाएं.

  2. नेविगेशन SDK टूल की लाइब्रेरी को, demo प्रोजेक्ट की app/libs डायरेक्ट्री में कॉपी करें:

    उदाहरण के लिए, आप अपने Linux टर्मिनल में cp libs/*.aar demo/app/libs चला सकते हैं.

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

  4. ऐप्लिकेशन का AndroidManifest.xml खोलें और API_KEY प्रॉपर्टी की वैल्यू अपडेट करें:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

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

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

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

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

ऐप्लिकेशन चलाएं

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

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

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

  3. नेविगेशन डेमो ऐप्लिकेशन में, डेस्टिनेशन सेट करें चुनें. इसके बाद, जगह चुनने और सिम्युलेटेड नेविगेशन शुरू करने के लिए, निर्देशों का पालन करें.

व्यू वैरिएंट बनाना

डेमो ऐप्लिकेशन में व्यू का एक वैरिएंट शामिल होता है.

  1. Android Studio में, डेमो ऐप्लिकेशन खोलें और बिल्ड विंडो में 'वैरिएंट बनाएं' टैब पर क्लिक करें.

  2. वैरिएंट बनाएं विंडो में, viewDebug चुनें. इसके बाद, फ़ाइल की सूची बदल जाती है.

  3. NavigationView क्लास के लिए, SDK टूल लागू करने से जुड़ी जानकारी की जांच करें.

    • NavViewActivity.java में, लागू करने के कोड को नोट करें.

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

  4. ऐप्लिकेशन बनाएं और चलाएं. ऐप्लिकेशन का नाम बदलकर यह बताता है कि कौनसा वर्शन बनाया गया है. ऐसा न होने पर, सिर्फ़ रेंडरिंग ऑब्जेक्ट अलग होता है.

अगला कदम

अपने ऐप्लिकेशन में Android के लिए नेविगेशन SDK टूल जोड़ें.