Maps Android KTX

Maps Android Kotlin extensions (KTX), Android के लिए Maps SDK और Android के लिए Maps SDK की उपयोगिता लाइब्रेरी के लिए, Kotlin एक्सटेंशन का कलेक्शन है. इन एक्सटेंशन में Kotlin भाषा की ऐसी सुविधाएं मिलती हैं जिनकी मदद से, Android के लिए Maps SDK के लिए डेवलपमेंट करते समय, Kotlin में कम शब्दों में और सही तरीके से कोड लिखा जा सकता है. Maps KTX, ओपन सोर्स है और GitHub पर उपलब्ध है. इसके साथ-साथ, उदाहरण भी दिए गए हैं.

इंस्टॉल करने की सुविधा

Android के लिए Maps SDK के लिए KTX इंस्टॉल करने के लिए, अपनी build.gradle.kts फ़ाइल में ये डिपेंडेंसी जोड़ें. इसके अलावा, Android के लिए Maps SDK की उपयोगिता लाइब्रेरी के लिए भी KTX इंस्टॉल किया जा सकता है.

dependencies {

    // Maps SDK for Android Utils library (includes KTX extensions)
    implementation(libs.android.maps.utils)
}

इस्तेमाल से जुड़े उदाहरण

KTX लाइब्रेरी की मदद से, Kotlin भाषा की कई सुविधाओं का फ़ायदा लिया जा सकता है. जैसे, एक्सटेंशन फ़ंक्शन, नाम वाले पैरामीटर और डिफ़ॉल्ट आर्ग्युमेंट, डिस्ट्रक्चरिंग डिक्लेरेशन, और कोरोटीन.

कोरोटीन का इस्तेमाल करके GoogleMap को वापस पाना

GoogleMap को कोरोटीन का इस्तेमाल करके वापस पाया जा सकता है.

scope.launch {
    if (context is FragmentActivity) {
        val mapFragment =
            context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        val googleMap = mapFragment?.awaitMap()
    }
}

मार्कर जोड़ना

DSL-स्टाइल वाले addMarker() तरीके का इस्तेमाल करके, मार्कर जोड़ा जा सकता है.

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
    position(sydney)
    title("Marker in Sydney")
}

कैमरे से जुड़े इवेंट का डेटा इकट्ठा करना

कैमरे की गतिविधियों जैसे इवेंट का डेटा, Kotlin Flow के ज़रिए इकट्ठा किया जा सकता है.

scope.launch {
    googleMap.cameraMoveEvents().collect {
        Log.d("KTX", "Received camera move event")
    }
}

रेफ़रंस दस्तावेज़ पढ़कर, इस्तेमाल की जा सकने वाली सुविधाओं की पूरी सूची देखी जा सकती है.

सैंपल ऐप्लिकेशन आज़माएं

इस लाइब्रेरी के लिए GitHub रिपॉज़िटरी में, एक डेमो ऐप्लिकेशन भी शामिल है. इससे पता चलता है कि अपने ऐप्लिकेशन में Maps KTX लाइब्रेरी का इस्तेमाल कैसे किया जा सकता है.

डेमो ऐप्लिकेशन आज़माने के लिए, यह तरीका अपनाएं:

1. GitHub से, ZIP फ़ाइल को क्लोन करें या डाउनलोड करें.
2. Android Studio में, फ़ाइल -> खोलें को चुनें. इसके बाद, उस डायरेक्ट्री पर जाएं और उस फ़ोल्डर को खोलें जिसे आपने अभी-अभी क्लोन या डाउनलोड किया है.
3. डेमो ऐप्लिकेशन में कोई एपीआई पासकोड जोड़ें.
1. Android के लिए Maps SDK का पासकोड पाएं.
2. रूट डायरेक्ट्री में, secrets.properties नाम की एक फ़ाइल बनाएं. एपीआई पासकोड को सुरक्षित रखने के लिए, इस फ़ाइल को वर्शन कंट्रोल में शामिल न करें.
3. secrets.properties
   में यह लाइन जोड़ें

   MAPS_API_KEY="YOUR_API_KEY"

   यहां YOUR_API_KEY वह एपीआई पासकोड है जो आपको पहले चरण में मिला था. secrets.defaults.properties को उदाहरण के तौर पर देखा जा सकता है.
4. रन कॉन्फ़िगरेशन में जाकर, app-ktx मॉड्यूल चुनें.
5. 'app-ktx' चलाएं को चुनें.

आगे क्या करना है

Google Maps Platform के लिए, Kotlin एक्सटेंशन की अन्य लाइब्रेरी में भी आपकी दिलचस्पी हो सकती है:

• Android के लिए Map SDK की उपयोगिता लाइब्रेरी के लिए KTX
• KTX के लिए Places SDK के लिए KTX