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 के लिए 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मैप को वापस पाना

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 फ़्लो की मदद से इकट्ठा किया जा सकता है.

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 की एक्सटेंशन लाइब्रेरी में भी आपकी दिलचस्पी हो सकती है:

• KTX: Android उपयोगिता लाइब्रेरी के लिए, Maps SDK टूल
• Android के लिए, Places SDK टूल के लिए KTX