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