Maps Android Kotlin एक्सटेंशन (KTX), Android के लिए Maps SDK टूल और Android के लिए Maps SDK टूल की यूटिलिटी लाइब्रेरी के लिए Kotlin एक्सटेंशन का कलेक्शन है. ये एक्सटेंशन, Kotlin लैंग्वेज की सुविधाएं देते हैं. इनकी मदद से, Android के लिए Maps SDK टूल के लिए कम शब्दों में और आसानी से Kotlin कोड लिखा जा सकता है. 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 लैंग्वेज का फ़ायदा लिया जा सकता है एक्सटेंशन फ़ंक्शन, नाम वाले पैरामीटर, और डिफ़ॉल्ट आर्ग्युमेंट जैसी सुविधाएं, डिस्ट्रक्चरिंग डिक्लेरेशन, और कोरूटीन.
कोरूटीन का इस्तेमाल करके GoogleMap को वापस लाना
कोरूटीन का इस्तेमाल करके, GoogleMap को ऐक्सेस किया जा सकता है.
lifecycleScope.launch {
lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
val mapFragment: SupportMapFragment? =
supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
val googleMap: GoogleMap? = mapFragment?.awaitMap()
}
}
मार्कर जोड़ना
मार्कर जोड़ने के लिए, DSL-स्टाइल वाले तरीके addMarker() का इस्तेमाल किया जा सकता है.
val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
position(sydney)
title("Marker in Sydney")
}
कैमरे से रिकॉर्ड की गई गतिविधियां
Kotlin Flow की मदद से, कैमरे के मूवमेंट जैसे इवेंट इकट्ठा किए जा सकते हैं.
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 की अन्य एक्सटेंशन लाइब्रेरी में भी हो: