सेटअप

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

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

Android के लिए Maps 3D SDK का इस्तेमाल करके ऐप्लिकेशन बनाना शुरू करने से पहले, आपको 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 एसडीके के साथ इस्तेमाल करने के लिए, 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 plugin जोड़ें:

   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 डायरेक्ट्री में होती है. - वर्शन सेक्शन में, एसडीके और Secrets Gradle प्लगइन के वर्शन जोड़ें:

   maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
   secretsGradlePlugin = "2.0.1"
   

   -   In the library section, add the SDK library:
   

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

   -   In the plugin section, add the Secrets Gradle plugin:
   

   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
   }
   

   -   In the `dependencies` block, add the SDK:
   

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

   -   At the end of the file, outside of the `android` and `dependencies`
       blocks, add the secrets configuration:
   

   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
   ``` Note: Make sure you
       replace `YOUR_API_KEY_HERE` with the API key that you configured for use
   with the Maps 3D SDK for Android.
   

2. local.defaults.properties फ़ाइल बनाएं: - ऐप्लिकेशन मॉड्यूल की रूट डायरेक्ट्री में, 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 Plugin, ${MAPS3D_API_KEY} प्लेसहोल्डर को आपकी secrets.properties फ़ाइल में मौजूद कुंजी से बदल देगा.

अगले चरण

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