Android यूटिलिटी सेटअप के लिए Maps SDK टूल

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

ज़रूरतें और अहम जानकारी

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

रेफ़रंस दस्तावेज़, GitHub पर उपलब्ध है.

पहला चरण. Android के लिए Maps SDK की यूटिलिटी लाइब्रेरी इंस्टॉल करना

अपने ऐप्लिकेशन की build.gradle.kts फ़ाइल में, यह डिपेंडेंसी जोड़ें:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.19.0")
}

लाइब्रेरी की किसी एक यूटिलिटी का इस्तेमाल करें. जैसे, मार्कर क्लस्टरिंग, हीटमैप या अन्य यूटिलिटी का इस्तेमाल करें.

दूसरा चरण. (ज़रूरी नहीं) Android के लिए Maps SDK की यूटिलिटी KTX लाइब्रेरी इंस्टॉल करना

Android के लिए Maps SDK की यूटिलिटी लाइब्रेरी के साथ, Kotlin एक्सटेंशन (KTX) लाइब्रेरी भी मिलती है. इस लाइब्रेरी में Kotlin लैंग्वेज की सुविधाएं मिलती हैं. जैसे, एक्सटेंशन फ़ंक्शन, नाम वाले और डिफ़ॉल्ट आर्ग्युमेंट. इनकी मदद से, Kotlin में कम शब्दों में और सही तरीके से कोड लिखा जा सकता है. अगर Kotlin में डेवलपमेंट नहीं किया जा रहा है, तो इस चरण को छोड़ा जा सकता है.

इस लाइब्रेरी का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन की build.gradle.kts फ़ाइल में android-maps-utils डिपेंडेंसी के अलावा, यह डिपेंडेंसी जोड़ें:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

इस लाइब्रेरी के बारे में ज़्यादा जानकारी पाने के लिए, Maps KTX का GitHub पेज देखें.

तीसरा चरण. Android के लिए Maps SDK की यूटिलिटी लाइब्रेरी का सोर्स कोड देखना

यूटिलिटी लाइब्रेरी ओपन सोर्स है. इसलिए, android-maps-utils लाइब्रेरी को अपने डिवाइस पर डाउनलोड किया जा सकता है. इससे, इसे पसंद के मुताबिक बनाया जा सकता है, डेमो ऐप्लिकेशन देखा जा सकता है या यह समझा जा सकता है कि लाइब्रेरी कैसे काम करती है. इसके लिए, रिपो को क्लोन किया जा सकता है. हमारा सुझाव है कि ऐसा करें, ताकि आपको अपडेट अपने-आप मिलते रहें. इसके अलावा, zip फ़ाइल डाउनलोड की जा सकती है. अगर लाइब्रेरी को पसंद के मुताबिक बनाना है, तो आपको रिपो को फ़ोर्क करना चाहिए.

रिपॉज़िटरी में ये चीज़ें शामिल हैं:

• demo डायरेक्ट्री में, एक डेमो ऐप्लिकेशन.
• library डायरेक्ट्री में, यूटिलिटी की लाइब्रेरी.
• लाइसेंस, योगदान देने वाले लोगों की जानकारी, और रीडमी की जानकारी वाली अलग-अलग फ़ाइलें.
• Android Studio के साथ इस्तेमाल करने के लिए, Gradle बिल्ड कॉन्फ़िगरेशन.

यूटिलिटी डेमो ऐप्लिकेशन चलाना

यूटिलिटी लाइब्रेरी के लिए GitHub रिपॉज़िटरी में, एक डेमो ऐप्लिकेशन शामिल होता है. इसमें हर यूटिलिटी के सैंपल लागू करने के तरीके दिए गए होते हैं. अपने Android डिवाइस पर डेमो ऐप्लिकेशन चलाने के लिए, यह तरीका अपनाएं.

1. ऊपर बताए गए किसी एक विकल्प का इस्तेमाल करके, रिपॉज़िटरी डाउनलोड करें.
2. Android Studio में, फ़ाइल -> नया -> प्रोजेक्ट इंपोर्ट करें को चुनें.
3. उस android-maps-utils डायरेक्ट्री पर जाएं और उसे चुनें (दो बार क्लिक करें) जो यूटिलिटी लाइब्रेरी को क्लोन करने पर बनी थी. Android Studio अब प्रोजेक्ट बनाता है.
4. अगर एम्युलेटर के बजाय Android डिवाइस का इस्तेमाल किया जा रहा है, तो पक्का करें कि डेवलपर मोड चालू हो. इसके बाद, Android डिवाइस को अपने कंप्यूटर से कनेक्ट करें.

5. local.properties में एक लाइन जोड़ें, जो इस तरह दिखती हो:

   MAPS_API_KEY=YOUR_API_KEY

   यहां YOUR_API_KEY, वह एपीआई कुंजी है जो आपको एपीआई कुंजियों का इस्तेमाल करना में बताए गए तरीके से मिली है.

6. डेमो ऐप्लिकेशन बनाएं और चलाएं.

ऐप्लिकेशन, Android डिवाइस पर खुलना चाहिए. इसमें क्लस्टरिंग, पॉलीयूटिल, हीटमैप वगैरह जैसी यूटिलिटी की सूची दिखनी चाहिए. **Maps Utils Demo** नाम से, ऐप्लिकेशन को अपनी ऐप्लिकेशन सूची में भी देखा जा सकता है.