इस पेज पर Android यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल सेट अप करने और लाइब्रेरी में शामिल डेमो ऐप्लिकेशन को चलाने का तरीका बताया गया है.
ज़रूरतें और नोट
Android यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल, Android एपीआई लेवल 15 और इसके बाद के वर्शन के साथ काम करता है. अपना प्रोजेक्ट बिल्ड टारगेट सेट करते समय, पक्का करें कि आप नए Android API लेवल का इस्तेमाल करें.
रेफ़रंस दस्तावेज़ GitHub पर उपलब्ध है.
पहला चरण. Android यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल इंस्टॉल करना
अपने ऐप्लिकेशन की build.gradle फ़ाइल में यह डिपेंडेंसी जोड़ें:
dependencies {
implementation 'com.google.maps.android:android-maps-utils:2.3.0'
}
लाइब्रेरी की किसी उपयोगिता का इस्तेमाल करें, जैसे कि मार्कर क्लस्टरिंग, हीटमैप या अन्य सुविधाओं.
दूसरा चरण. (ज़रूरी नहीं) Android की उपयोगिता वाली KTX लाइब्रेरी के लिए, Maps SDK टूल इंस्टॉल करें
Android यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल, उससे जुड़ी Kotlin एक्सटेंशन (KTX) लाइब्रेरी के साथ आता है. यह लाइब्रेरी, Kotlin लैंग्वेज की सुविधाएं उपलब्ध कराती है. जैसे, एक्सटेंशन फ़ंक्शन, नाम और डिफ़ॉल्ट आर्ग्युमेंट. ये आपको छोटे और मुहावरेदार Kotlin लिखने की सुविधा देते हैं. अगर आप Kotlin में नहीं डेवलप कर रहे हैं, तो आप यह चरण छोड़ सकते हैं.
इस लाइब्रेरी का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन की build.gradle फ़ाइल के साथ-साथ
android-maps-utils डिपेंडेंसी में ये डिपेंडेंसी जोड़ें:
dependencies {
implementation 'com.google.maps.android:maps-utils-ktx:3.4.0'
}
इस लाइब्रेरी के बारे में ज़्यादा जानकारी के लिए, Maps KTX GitHub पेज देखें.
तीसरा चरण. Android यूटिलिटी लाइब्रेरी के सोर्स कोड के लिए Maps SDK टूल देखें
Utility लाइब्रेरी एक ओपन सोर्स है. इसलिए, अपनी मशीन को पसंद के मुताबिक बनाने के लिए, android-maps-utils लाइब्रेरी को डाउनलोड करें. साथ ही, डेमो ऐप्लिकेशन देखें या लाइब्रेरी के काम करने के तरीके के बारे में जानना हो. ऐसा करने के लिए, आप रेपो को क्लोज़ करके (अपने-आप अपडेट पाने की सलाह दी जाती है) या पिन फ़ाइल डाउनलोड करके ऐसा कर सकते हैं. अगर आप लाइब्रेरी को पसंद के मुताबिक बनाना चाहते हैं, तो आपको रेपो को फ़ोर्क करना चाहिए.
रिपॉज़िटरी में ये शामिल हैं:
demoडायरेक्ट्री में, एक डेमो ऐप्लिकेशन है.libraryडायरेक्ट्री में यूटिलिटी लाइब्रेरी.library-v3डायरेक्ट्री में, v3 बीटा के लिए Maps SDK टूल के लिए यूटिलिटी लाइब्रेरी.- ऐसी कई फ़ाइलें हैं जिनमें लाइसेंस, योगदान देने वालों, और रीडमी की जानकारी शामिल होती है.
- Android Studio के साथ इस्तेमाल करने के लिए, Gradle बिल्ड कॉन्फ़िगरेशन.
Utility डेमो ऐप्लिकेशन चलाएं
Utility लाइब्रेरी के लिए GitHub डेटा स्टोर करने की जगह, एक डेमो ऐप्लिकेशन के साथ शिप करती है. इसमें, हर यूटिलिटी का सैंपल लागू किया जाता है. अपने Android डिवाइस पर डेमो ऐप्लिकेशन चलाने के लिए यह तरीका अपनाएं.
- ऊपर दिए गए विकल्पों में से किसी एक का इस्तेमाल करके, डेटा स्टोर करने की जगह डाउनलोड करें.
- Android Studio में, फ़ाइल -> नया -> प्रोजेक्ट इंपोर्ट करें चुनें.
- ब्राउज़ करें और android-maps-utils डायरेक्ट्री चुनें (डबल क्लिक करके). यह डायरेक्ट्री तब बनाई गई थी, जब आपने यूटिलिटी लाइब्रेरी को क्लोन किया था. Android Studio अब प्रोजेक्ट बनाता है.
- अगर आप एम्युलेटर के बजाय Android डिवाइस का इस्तेमाल कर रहे हैं, तो डेवलपर मोड चालू करना न भूलें. इसके बाद, अपने कंप्यूटर पर Android डिवाइस जोड़ें.
local.propertiesकी तरह एक लाइन जोड़ें:MAPS_API_KEY=YOUR_API_KEY
यहां YOUR_API_KEY एक एपीआई कुंजी है, जैसा कि आपने एपीआई कुंजियों का इस्तेमाल में बताया है.
- डेमो ऐप्लिकेशन बनाएं और उसे चलाएं.
ऐप्लिकेशन को Android डिवाइस पर खुलना चाहिए, जिसमें क्लस्टरिंग, poyutil, हीटमैप वगैरह जैसी उपयोगिताओं की सूची दिखाई देगी. ऐप्लिकेशन को अपनी ऐप्लिकेशन की सूची में, Maps का इस्तेमाल का डेमो नाम में भी देखा जा सकता है.