Maps Android KTX

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

इंस्टॉल करना

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

dependencies {

    // KTX for the Maps SDK for Android library
    implementation("com.google.maps.android:maps-ktx:5.2.0")
}

इस्तेमाल के उदाहरण

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()
  }
}

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

मार्कर जोड़ने के लिए, डीएसएल-स्टाइल वाले 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 में, 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 Utility Library के लिए Map SDK टूल का KTX
  • Android के लिए Places SDK के लिए KTX