Maps Android Kotlin एक्सटेंशन (KTX), Android के लिए Maps SDK टूल और Android यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल के लिए, Kotlin एक्सटेंशन का संग्रह है. ये एक्सटेंशन Kotlin भाषा की सुविधाएं देते हैं, जिनकी मदद से आप Android के लिए Maps SDK टूल को डेवलप करते समय कम शब्दों में और मुहावरे वाला Kotlin लिख सकते हैं. Maps KTX ओपन सोर्स फ़ॉर्मैट में है और GitHub पर उदाहरण के साथ उपलब्ध है.
इंस्टॉल करना
Android के लिए Maps SDK टूल के लिए KTX इंस्टॉल करने और Android यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल के लिए, अपनी 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()
}
}
मार्कर जोड़ना
मार्कर जोड़ने के लिए, DSL शैली वाले 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 एक्सटेंशन लाइब्रेरी में भी हो सकती है: