Maps Android KTX

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

इंस्टॉल करना

Maps SDK for Android के लिए KTX इंस्टॉल करने के लिए, अपनी build.gradle.kts फ़ाइल में ये डिपेंडेंसी जोड़ें. अगर आपको Maps SDK for Android Utility Library के लिए 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()
    }
}

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

मार्कर जोड़ने के लिए, डीएसएल-स्टाइल वाले तरीके 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 में, File -> Open को चुनें. इसके बाद, डायरेक्ट्री पर जाएं और उस फ़ोल्डर को खोलें जिसे आपने अभी-अभी क्लोन या डाउनलोड किया है.
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 के लिए Maps SDK की उपयोगिता लाइब्रेरी के लिए KTX
• Places SDK for Android के लिए KTX