Maps Android KTX

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

इंस्टॉल करना

Android के लिए Maps SDK टूल और ज़रूरत पड़ने पर, Android Utility लाइब्रेरी के लिए KTX इंस्टॉल करने के लिए, अपनी 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 लाइब्रेरी का इस्तेमाल कैसे किया जा सकता है.

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

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 Utility लाइब्रेरी के लिए Maps SDK टूल के लिए KTX
• Android के लिए Places SDK टूल के साथ इस्तेमाल किया जाने वाला KTX