Maps Android Kotlin एक्सटेंशन (KTX), Android के लिए Maps SDK टूल और Android Utility Library के लिए Maps SDK के लिए Kotlin एक्सटेंशन का एक कलेक्शन है. इन एक्सटेंशन की मदद से, Kotlin की भाषा में सुविधाओं का इस्तेमाल किया जा सकता है. Android के लिए Maps SDK टूल को डेवलप करते समय, छोटे और मज़ेदार Kotlin की मदद से लिखा जा सकता है. Maps KTX ओपन सोर्स है और GitHub पर उदाहरण के साथ उपलब्ध है.
इंस्टॉल करना
Android के लिए Maps SDK टूल और वैकल्पिक रूप से, Android Utility Library के लिए Maps SDK टूल के लिए KTX इंस्टॉल करने के लिए, अपनी build.gradle फ़ाइल में ये डिपेंडेंसी जोड़ें.
dependencies {
// KTX for the Maps SDK for Android library
implementation 'com.google.maps.android:maps-ktx:5.0.0'
}
इस्तेमाल के उदाहरण
KTX लाइब्रेरी की मदद से, Kotlin की कई भाषाओं की सुविधाओं का फ़ायदा लिया जा सकता है. जैसे, एक्सटेंशन फ़ंक्शन, नाम वाले पैरामीटर, डिफ़ॉल्ट आर्ग्युमेंट, डिस्ट्रक्चर करने वाले एलान, और कोरूटीन.
कोरूटीन का इस्तेमाल करके Google Maps को फिर से हासिल करना
GoogleMap को ऐक्सेस करने के लिए, कोरूटीन इस्तेमाल
किया जा सकता है.
lifecycleScope.launch {
lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
val mapFragment: SupportMapFragment? =
supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
val googleMap: GoogleMap? = mapFragment?.awaitMap()
}
}
एक मार्कर जोड़ना
मार्कर जोड़ने के लिए डीएसएल शैली वाले addMarker() तरीके का इस्तेमाल किया जा सकता है.
val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
position(sydney)
title("Marker in Sydney")
}
कैमरे की गतिविधियों का डेटा इकट्ठा किया जा रहा है
Kotlin फ़्लो की मदद से कैमरे की मूवमेंट जैसे इवेंट इकट्ठा किए जा सकते हैं.
lifecycleScope.launch {
lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
googleMap.cameraMoveEvents().collect {
print("Received camera move event")
}
}
}
रेफ़रंस दस्तावेज़ पढ़कर, इस्तेमाल की जा सकने वाली सुविधाओं की पूरी सूची देखी जा सकती है.
सैंपल ऐप्लिकेशन आज़माएं
इस लाइब्रेरी के लिए GitHub रिपॉज़िटरी में एक डेमो ऐप्लिकेशन भी शामिल है. इसमें यह दिखाया गया है कि अपने ऐप्लिकेशन में Maps KTX लाइब्रेरी को इस्तेमाल करने का तरीका क्या है.
डेमो ऐप्लिकेशन आज़माने के लिए, यह तरीका अपनाएं:
- GitHub से, ZIP फ़ाइल का क्लोन बनाएं या उसे डाउनलोड करें.
- Android Studio में, फ़ाइल -> खोलें चुनें और डायरेक्ट्री में जाएं. इसके बाद, वह फ़ोल्डर खोलें जिसे आपने अभी-अभी क्लोन किया है या डाउनलोड किया है.
- डेमो ऐप्लिकेशन में एपीआई पासकोड जोड़ें.
- Android पासकोड के लिए Maps SDK टूल पाएं.
- रूट डायरेक्ट्री में,
secrets.propertiesनाम की फ़ाइल बनाएं. आपकी एपीआई कुंजी की सुरक्षा के लिए, यह फ़ाइल वर्शन कंट्रोल में नहीं होनी चाहिए. - इस सिंगल लाइन को
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
में जोड़ें, जहांYOUR_API_KEYपहले चरण में मिली असल एपीआई कुंजी है. उदाहरण के लिए,secrets.defaults.propertiesको देखें. - रन कॉन्फ़िगरेशन में, app-ktx मॉड्यूल चुनें.
- 'app-ktx' चलाएं को चुनें.
आगे क्या करना है
Google Maps Platform के लिए, आपकी अन्य Kotlin एक्सटेंशन लाइब्रेरी में भी दिलचस्पी हो सकती है: