Maps Android Kotlin एक्सटेंशन (KTX), Maps SDK टूल के लिए Kotlin एक्सटेंशन का कलेक्शन है Android उपयोगिता लाइब्रेरी के लिए Android और Maps SDK टूल. ये एक्सटेंशन, Kotlin लैंग्वेज की सुविधाएं, जिनसे आपको छोटा और मुहावरेदार Kotlin लिखने में मदद मिलती है जब हम Android के लिए Maps SDK टूल डेवलप करते हैं. Maps KTX ओपन सोर्स है और GitHub पर उपलब्ध उदाहरण.
इंस्टॉल करना
Android के लिए Maps SDK के लिए KTX इंस्टॉल करने और वैकल्पिक रूप से
Android यूटिलिटी लाइब्रेरी, अपने build.gradle.kts में ये डिपेंडेंसी जोड़ें
फ़ाइल से लिए जाते हैं.
dependencies {
// KTX for the Maps SDK for Android library
implementation("com.google.maps.android:maps-ktx:5.1.1")
}
इस्तेमाल के उदाहरण
KTX लाइब्रेरी की मदद से, कई Kotlin लैंग्वेज का फ़ायदा लिया जा सकता है एक्सटेंशन फ़ंक्शन, नाम वाले पैरामीटर, और डिफ़ॉल्ट आर्ग्युमेंट जैसी सुविधाएं, डिस्ट्रक्चरिंग डिक्लेरेशन, और कोरूटीन.
कोरूटीन का इस्तेमाल करके Googleमैप को वापस पाना
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 के लिए, Kotlin की अन्य एक्सटेंशन लाइब्रेरी में भी आपकी दिलचस्पी हो सकती है प्लैटफ़ॉर्म: