Android क्विकस्टार्ट के लिए Maps SDK टूल

एक ऐसा Android ऐप्लिकेशन बनाएं, जो Google मैप दृश्य का उपयोग करके मैप दिखाता हो टेम्प्लेट पर जाएं. अगर आपके पास कोई मौजूदा Android Studio प्रोजेक्ट है और आपको उसे सेट अप करना है, तो Android Studio प्रोजेक्ट सेट अप करना लेख पढ़ें.

यह क्विकस्टार्ट उन डेवलपर के लिए है जिन्हें बुनियादी जानकारी है Kotlin या Java के साथ Android डेवलपमेंट.

डेवलपमेंट एनवायरमेंट के बारे में जानकारी

इस क्विकस्टार्ट को Android Studio Hedgehog और Android Gradle प्लग इन के 8.2 वर्शन का इस्तेमाल करके डेवलप किया गया था.

Android डिवाइस सेट अप करें

Maps SDK for Android का इस्तेमाल करने वाले ऐप्लिकेशन को चलाने के लिए, आपको उसे Android 5.0 या इसके बाद के वर्शन पर आधारित किसी Android डिवाइस या Android एमुलेटर पर डिप्लॉय करना होगा. साथ ही, उसमें Google API भी शामिल होने चाहिए.

• Android डिवाइस का इस्तेमाल करने के लिए, हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाना लेख में दिए गए निर्देशों का पालन करें.
• Android एम्युलेटर का इस्तेमाल करने के लिए, वर्चुअल डिवाइस बनाएं और एम्युलेटर इंस्टॉल करें. इसके लिए, Android Studio में मौजूद Android वर्चुअल डिवाइस (AVD) मैनेजर का इस्तेमाल करें.

Android Studio में Google Maps प्रोजेक्ट बनाना

Android Studio में Google Maps प्रोजेक्ट बनाने का तरीका, Flamingo और उसके बाद के रिलीज़ में बदल गया है.

1. Android Studio खोलें और इसमें नया प्रोजेक्ट पर क्लिक करें Android Studio में आपका स्वागत है विंडो.

2. नया प्रोजेक्ट विंडो में, फ़ोन और टैबलेट कैटगरी में, कोई गतिविधि नहीं को चुनें और फिर आगे बढ़ें पर क्लिक करें.

3. नया प्रोजेक्ट फ़ॉर्म भरें:

   • भाषा को Java या Kotlin पर सेट करें. दोनों भाषाएँ, Android के लिए Maps SDK टूल. Kotlin के बारे में ज़्यादा जानने के लिए, यहां देखें Kotlin की मदद से Android ऐप्लिकेशन डेवलप करना.

   • SDK टूल का कम से कम लेवल, टेस्टिंग के लिए इस्तेमाल किए जा रहे डिवाइस के साथ काम करने वाले SDK टूल के वर्शन पर सेट करें. आपको ऐसा वर्शन चुनना होगा जो Android के 19.0.x वर्शन के लिए Maps SDK टूल, यह Android एपीआई लेवल 21 ("Lollipop"; Android 5.0) या इसके बाद का वर्शन है. इनके लिए रिलीज़ नोट देखें SDK टूल के वर्शन की ज़रूरी शर्तों के बारे में नई जानकारी.

   • बिल्ड कॉन्फ़िगरेशन की भाषा को Kotlin DSL या Groovy DSL पर सेट करें. दोनों बिल्ड कॉन्फ़िगरेशन भाषाओं के स्निपेट यहां दिखाए गए हैं प्रोसेस को अंजाम देते हैं.

4. पूरा करें पर क्लिक करें.

   Android Studio, Gradle को शुरू करता है और प्रोजेक्ट बनाता है. इसमें थोड़ा समय लग सकता है.

5. Google मैप दृश्य गतिविधि जोड़ें:

   1. अपने प्रोजेक्ट में app फ़ोल्डर पर राइट क्लिक करें.

   2. नया > चुनें Google > Google Maps व्यू की गतिविधि.

      

   3. नई Android गतिविधि डायलॉग बॉक्स में, लॉन्चर गतिविधि चेकबॉक्स चुनें.

   4. पूरा करें चुनें.

      ज़्यादा जानकारी के लिए, टेंप्लेट से कोड जोड़ना लेख पढ़ें

6. बिल्ड पूरा होने के बाद, Android Studio AndroidManifest.xml को खोलता है और MapsActivity फ़ाइलें शामिल हैं. आपकी गतिविधि का नाम अलग हो सकता है, लेकिन यह वही नाम है जिसे आपने सेटअप के दौरान कॉन्फ़िगर किया था.

अपना Google Cloud प्रोजेक्ट सेट अप करना

Cloud Console को सेटअप करने के लिए, यहां दिए गए टैब पर क्लिक करें:

gcloud projects create "PROJECT"

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना

इस सेक्शन में, एपीआई पासकोड को सेव करने का तरीका बताया गया है, ताकि आपका ऐप्लिकेशन उसका सुरक्षित तरीके से इस्तेमाल कर सके. आपको अपने वर्शन कंट्रोल सिस्टम में एपीआई पासकोड को सेव नहीं करना चाहिए. इसलिए, हमारा सुझाव है कि आप इसे secrets.properties फ़ाइल में सेव करें. यह फ़ाइल, आपके प्रोजेक्ट की रूट डायरेक्ट्री में होती है. secrets.properties फ़ाइल के बारे में ज़्यादा जानकारी के लिए, देखें Gredle प्रॉपर्टी की फ़ाइलें.

इस टास्क को आसान बनाने के लिए, हमारा सुझाव है कि आप Android के लिए सीक्रेट ग्रेडल प्लग इन.

अपने Google Maps प्रोजेक्ट में Android के लिए सीक्रेट ग्रेडल प्लग इन इंस्टॉल करने के लिए:

1. Android Studio में, अपना टॉप-लेवल build.gradle.kts या build.gradle खोलें फ़ाइल और निम्न कोड को dependencies तत्व में जोड़ें buildscript.

   Kotlin

   buildscript {
       dependencies {
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
       }
   }

   ग्रूवी

   buildscript {
       dependencies {
           classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
       }
   }

2. मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल खोलें और plugins एलिमेंट में यह कोड जोड़ें.

   Kotlin

   plugins {
       // ...
       id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   }

   ग्रूवी

   plugins {
       // ...
       id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   }

3. अपने मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल में, पक्का करें कि वह targetSdk और compileSdk सेट हैं 34 तक.
4. फ़ाइल सेव करें और अपने प्रोजेक्ट को Gradle के साथ सिंक करें.
5. अपनी शीर्ष-स्तरीय डायरेक्ट्री में secrets.properties फ़ाइल खोलें, और फिर जोड़ें . YOUR_API_KEY को अपनी एपीआई पासकोड से बदलें. अपनी कुंजी को इस फ़ाइल में सेव करें, क्योंकि secrets.properties को वर्शन कंट्रोल सिस्टम में शामिल नहीं किया जाता.

   MAPS_API_KEY=YOUR_API_KEY

6. फ़ाइल सेव करें.

7. अपनी टॉप-लेवल डायरेक्ट्री में local.defaults.properties फ़ाइल बनाएं, जो कि फ़ोल्डर को secrets.properties फ़ाइल के रूप में चुनकर यह कोड जोड़ें.

   MAPS_API_KEY=DEFAULT_API_KEY

   इस फ़ाइल का मकसद, एपीआई पासकोड का बैकअप सेव करना है. ऐसा इसलिए किया जाता है, ताकि अगर secrets.properties फ़ाइल न मिले, तो भी बिल्ड न रुके. ऐसा तब हो सकता है, जब आपने वर्शन कंट्रोल सिस्टम से ऐप्लिकेशन का क्लोन बनाया है. इसमें secrets.properties और आपने अभी तक स्थानीय भाषा में secrets.properties फ़ाइल नहीं बनाई है. एपीआई पासकोड.

8. फ़ाइल सेव करें.
9. अपनी AndroidManifest.xml फ़ाइल में, इस पर जाएं com.google.android.geo.API_KEY और android:value attribute अपडेट करें. अगर <meta-data> टैग मौजूद नहीं है, तो इसे <application> टैग के चाइल्ड के तौर पर बनाएं.

   <meta-data
       android:name="com.google.android.geo.API_KEY"
       android:value="${MAPS_API_KEY}" />

   ध्यान दें: com.google.android.geo.API_KEY सुझाया गया मेटाडेटा नाम है एपीआई पासकोड के लिए. इस नाम वाली कुंजी का उपयोग एकाधिक को प्रमाणित करने के लिए किया जा सकता है Android प्लैटफ़ॉर्म पर Google Maps-आधारित एपीआई, जिनमें Android के लिए Maps SDK. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई com.google.android.maps.v2.API_KEY नाम का समर्थन करता है. इस लेगसी नाम का इस्तेमाल करके, सिर्फ़ Android Maps API v2 की पुष्टि की जा सकती है. कोई ऐप्लिकेशन, एपीआई पासकोड के मेटाडेटा के सिर्फ़ एक नाम का इस्तेमाल कर सकता है. अगर दोनों के बारे में बताया गया हो, तो एपीआई एक अपवाद देता है.

10. Android Studio में, अपने मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल खोलें और secrets प्रॉपर्टी में बदलाव करें. अगर secrets प्रॉपर्टी मौजूद नहीं है, तो उसे जोड़ें.

    propertiesFileName को secrets.properties पर सेट करने के लिए, प्लग इन की प्रॉपर्टी में बदलाव करें. साथ ही, defaultPropertiesFileName को local.defaults.properties पर सेट करें और कोई अन्य प्रॉपर्टी सेट करें.

    Kotlin

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

    ग्रूवी

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

कोड देखें

टेंप्लेट से मिले कोड की जांच करें. खास तौर पर, अपने Android Studio प्रोजेक्ट में ये फ़ाइलें देखें.

Maps पर की गई गतिविधि की फ़ाइल

मैप गतिविधि फ़ाइल, ऐप्लिकेशन की मुख्य गतिविधि है और में मैप को मैनेज करने और दिखाने के लिए कोड होता है. डिफ़ॉल्ट रूप से, जो फ़ाइल गतिविधि का पता लगाता है, MapsActivity.java या अगर आपने Kotlin को आपके ऐप्लिकेशन की भाषा, MapsActivity.kt.

मैप गतिविधि के मुख्य एलिमेंट:

• SupportMapFragment ऑब्जेक्ट, मैप के लाइफ़साइकल को मैनेज करता है. साथ ही, यह ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) का पैरंट एलिमेंट होता है.

• GoogleMap ऑब्जेक्ट, मैप के डेटा का ऐक्सेस देता है और व्यू. यह Android के लिए Maps SDK टूल की मुख्य क्लास है. मैप ऑब्जेक्ट की गाइड में, SupportMapFragment और GoogleMap ऑब्जेक्ट के बारे में ज़्यादा जानकारी दी गई है.

• moveCamera फ़ंक्शन, मैप को ऑस्ट्रेलिया के सिडनी के LatLng निर्देशांकों पर सेंटर में ले जाता है. आम तौर पर, मैप जोड़ते समय सबसे पहले मैप की जगह और कैमरे की सेटिंग कॉन्फ़िगर की जाती हैं. जैसे, व्यू ऐंगल, मैप का ओरिएंटेशन, और ज़ूम लेवल. ज़्यादा जानकारी के लिए, कैमरा और व्यू गाइड देखें.

• addMarker फ़ंक्शन इसके निर्देशांक में एक मार्कर जोड़ता है सिडनी. ज़्यादा जानकारी के लिए, मार्कर गाइड देखें.

मॉड्यूल की Gradle फ़ाइल

मॉड्यूल build.gradle.kts फ़ाइल में, Maps की यह डिपेंडेंसी शामिल है. Android के लिए Maps SDK टूल को इसके लिए ज़रूरत होती है.

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

Maps की डिपेंडेंसी को मैनेज करने के बारे में ज़्यादा जानने के लिए, वर्शन देखें.

एक्सएमएल लेआउट फ़ाइल

activity_maps.xml फ़ाइल, एक्सएमएल लेआउट फ़ाइल होती है. इसमें ऐप्लिकेशन के यूआई का स्ट्रक्चर तय होता है. फ़ाइल, res/layout डायरेक्ट्री में मौजूद है. activity_maps.xml फ़ाइल एक ऐसे फ़्रैगमेंट के बारे में बताती है जिसमें ये शामिल हैं एलिमेंट:

• tools:context, फ़्रैगमेंट की डिफ़ॉल्ट गतिविधि को MapsActivity पर सेट करता है. MapsActivity की जानकारी, Maps गतिविधि फ़ाइल में दी गई होती है.
• android:name फ़्रैगमेंट का क्लास नाम इस पर सेट करता है SupportMapFragment, जो मैप गतिविधि में इस्तेमाल किया जाने वाला फ़्रैगमेंट टाइप है फ़ाइल से लिए जाते हैं.

एक्सएमएल लेआउट फ़ाइल में यह कोड शामिल होता है:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

ऐप्लिकेशन को डिप्लॉय करें और चलाएं

ऐप्लिकेशन को चलाने पर, आपको एक मैप दिखेगा. यह मैप, सिडनी, ऑस्ट्रेलिया के केंद्र में होगा और उस पर एक मार्कर दिखेगा. इसकी इमेज यहां दी गई है.

ऐप्लिकेशन को डिप्लॉय और चलाने के लिए:

1. Android Studio में, अपना ऐप्लिकेशन चलाने के लिए, चालू करें मेन्यू विकल्प (या 'चलाएं' बटन आइकॉन) पर क्लिक करें.
2. कोई डिवाइस चुनने के लिए कहा जाने पर, इनमें से कोई एक विकल्प चुनें:
   • अपने कंप्यूटर से कनेक्ट किए गए Android डिवाइस को चुनें.
   • इसके अलावा, एमुलेटर लॉन्च करें रेडियो बटन चुनें और वह वर्चुअल डिवाइस चुनें जिसे आपने सेट अप किया है.
3. ठीक है पर क्लिक करें. Android Studio, आपका ऐप्लिकेशन बनाने के लिए Gradle को शुरू करेगा. इसके बाद, वह आपके डिवाइस या एमुलेटर पर नतीजे दिखाएगा. ऐप्लिकेशन के लॉन्च होने में कुछ मिनट लग सकते हैं.

अगले चरण

• मैप सेट अप करें: यह दस्तावेज़ आपके मैप के लिए शुरुआती और रनटाइम सेटिंग को सेट अप करने का तरीका बताता है, जैसे सुविधा का इस्तेमाल करती है.

• अपने Android ऐप्लिकेशन (Kotlin) में मैप जोड़ें: यह कोडलैब (कोड बनाना सीखना) आपको एक ऐसे ऐप्लिकेशन के बारे में जानकारी देगा जो Android के लिए Maps SDK.

• Maps Android KTX लाइब्रेरी का इस्तेमाल करना: इस Kotlin एक्सटेंशन (KTX) लाइब्रेरी की मदद से, Android के लिए Maps SDK टूल का इस्तेमाल करते समय, Kotlin भाषा की कई सुविधाओं का फ़ायदा लिया जा सकता है.