सेटअप

इस पेज पर, Android के लिए Maps 3D SDK की मदद से ऐप्लिकेशन बनाने के लिए, सेटअप करने का तरीका बताया गया है. सेटअप प्रोसेस में, एसडीके के साथ इस्तेमाल करने के लिए, Google Cloud प्रोजेक्ट और एपीआई को कॉन्फ़िगर करना शामिल है. इसके बाद, Android Studio प्रोजेक्ट सेट अप करना होता है. अपने ऐप्लिकेशन में पहला 3D मैप जोड़ने से पहले, यह तरीका अपनाएं.

Google Cloud प्रोजेक्ट और एपीआई पासकोड सेट अप करना

Android के लिए Maps 3D SDK की मदद से ऐप्लिकेशन बनाने से पहले, आपको Google Cloud प्रोजेक्ट और एपीआई पासकोड सेट अप करना होगा. इसके लिए, यह तरीका अपनाएं:

gcloud projects create "PROJECT"

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

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

एसडीके चालू करने के लिए, Google Cloud Console में Android के लिए Maps 3D SDK पेज देखें. इन चरणों को पूरा करने के बारे में ज़्यादा जानने के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.

Android Studio प्रोजेक्ट सेट अप करना

इस सेक्शन में, Android के लिए Maps 3D SDK के साथ इस्तेमाल करने के लिए, Android Studio प्रोजेक्ट बनाने और उसे कॉन्फ़िगर करने का तरीका बताया गया है.

पहला हिस्सा: अपना प्रोजेक्ट और Gradle कॉन्फ़िगरेशन सेट अप करना

1. Empty Views Activity टेंप्लेट का इस्तेमाल करके, नया Android Studio प्रोजेक्ट बनाएं.

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

   • अपने प्रोजेक्ट की रूट डायरेक्ट्री में, .gitignore फ़ाइल खोलें.
   • यह लाइन जोड़ें:

   secrets.properties
   

3. प्रोजेक्ट-लेवल की build.gradle.kts फ़ाइल अपडेट करें:

   • अपने प्रोजेक्ट की रूट डायरेक्ट्री में, build.gradle.kts फ़ाइल खोलें.
   • plugins ब्लॉक में, Secrets Gradle प्लगिन जोड़ें:

   plugins {
     alias(libs.plugins.android.application) apply false
     alias(libs.plugins.kotlin.android) apply false
     alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
   }
   

4. gradle/libs.versions.toml फ़ाइल अपडेट करें:

   • gradle/libs.versions.toml फ़ाइल खोलें. यह आम तौर पर, प्रोजेक्ट की रूट डायरेक्ट्री में मौजूद gradle डायरेक्ट्री में होती है.
   • [versions] सेक्शन में, एसडीके और Secrets Gradle प्लगिन के वर्शन जोड़ें:

   # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
   maps3dSdk = "0.2.0"
   # See https://github.com/google/secrets-gradle-plugin/releases for available releases
   secretsGradlePlugin = "2.0.1"
   

   • [library] सेक्शन में, एसडीके लाइब्रेरी जोड़ें:

   play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
   

   • [plugins] सेक्शन में, Secrets Gradle प्लगिन जोड़ें:

   secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }
   

5. मॉड्यूल-लेवल की app/build.gradle.kts फ़ाइल अपडेट करें:

   • मॉड्यूल-लेवल की build.gradle.kts फ़ाइल खोलें. यह आम तौर पर, app डायरेक्ट्री में होती है.
   • फ़ाइल में सबसे ऊपर, plugins ब्लॉक में Secrets Gradle प्लगिन जोड़ें:

   plugins {
       alias(libs.plugins.android.application)
       alias(libs.plugins.kotlin.android)
       alias(libs.plugins.secrets.gradle.plugin) // Add this line
   }
   

   • dependencies ब्लॉक में, एसडीके जोड़ें:

   dependencies {
       // ... other dependencies
       implementation(libs.play.services.maps3d) // Add this line
   }
   

   • फ़ाइल के आखिर में, android और dependencies ब्लॉक के बाहर, सीक्रेट कॉन्फ़िगरेशन जोड़ें:

   secrets {
       // Optionally specify a different filename containing your secrets.
       // The plugin defaults to "local.properties"
       propertiesFileName = "secrets.properties"
   
       // A properties file containing default secret values. This file can be
       // checked in version control.
       defaultPropertiesFileName = "local.defaults.properties"
   }
   

दूसरा हिस्सा: अपने प्रोजेक्ट में एपीआई पासकोड जोड़ना

1. secrets.properties फ़ाइल बनाएं:

   • ऐप्लिकेशन मॉड्यूल की रूट डायरेक्ट्री (आम तौर पर, app डायरेक्ट्री) में, secrets.properties नाम की नई फ़ाइल बनाएं.
   • फ़ाइल में अपना एपीआई पासकोड जोड़ें:

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   

2. एक local.defaults.properties फ़ाइल बनाएं: - ऐप्लिकेशन मॉड्यूल की रूट डायरेक्ट्री में, secrets.properties नाम की नई फ़ाइल बनाएं. - फ़ाइल में डिफ़ॉल्ट या प्लेसहोल्डर एपीआई पासकोड जोड़ें. इस फ़ाइल को वर्शन कंट्रोल में चेक किया जा सकता है:

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

तीसरा हिस्सा: अपनी AndroidManifest.xml फ़ाइल अपडेट करना

1. app/src/main/AndroidManifest.xml फ़ाइल खोलें.

2. अपने एपीआई पासकोड की जानकारी देने के लिए, <application> टैग में, <activity> टैग से पहले, यह <meta-data> एलिमेंट जोड़ें:

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

   बिल्ड प्रोसेस के दौरान, Secrets Gradle प्लगिन, ${MAPS3D_API_KEY} प्लेसहोल्डर की जगह, आपकी secrets.properties फ़ाइल से पासकोड डाल देगा.

अगले चरण

अब आपके पास Google Cloud प्रोजेक्ट, एपीआई पासकोड, और Android Studio प्रोजेक्ट है. इन्हें Android के लिए Maps 3D SDK के साथ इस्तेमाल किया जा सकता है. अब अपने ऐप्लिकेशन में 3D मैप जोड़ें.