सेटअप

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

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

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

चरण 1

कंसोल

  1. नया Cloud प्रोजेक्ट बनाने के लिए, Google Cloud Console में प्रोजेक्ट चुनने वाले पेज पर, प्रोजेक्ट बनाएं पर क्लिक करें.

    प्रोजेक्ट चुनने वाले पेज पर जाएं

  2. पक्का करें कि आपके Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू हो. पुष्टि करें कि आपके प्रोजेक्ट के लिए बिलिंग चालू है.

    Google Cloud, बिना किसी शुल्क के आज़माने की सुविधा देता है. मुफ़्त में आज़माने की अवधि 90 दिन या 300 डॉलर के शुल्क के बाद खत्म हो जाएगी. इनमें से जो भी पहले होगा. सदस्यता को कभी भी रद्द किया जा सकता है. ज़्यादा जानकारी के लिए, बिलिंग खाते के क्रेडिट और बिलिंग देखें.

Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

दूसरा चरण

Google Maps Platform का इस्तेमाल करने के लिए, आपको अपने प्रोजेक्ट में इस्तेमाल करने के लिए एपीआई या एसडीके टूल चालू करने होंगे.

ध्यान दें कि कुछ इंटिग्रेशन के लिए, आपको एक से ज़्यादा एपीआई/SDK टूल चालू करने होंगे. अगर आपको यह नहीं पता कि कौनसे एपीआई या SDK टूल चालू करने हैं, तो एपीआई पिकर का इस्तेमाल करें या उस एपीआई/SDK टूल के दस्तावेज़ देखें जिसका इस्तेमाल करना है.

एक या एक से ज़्यादा एपीआई या SDK टूल चालू करने के लिए:

कंसोल

  1. Google Maps Platform के ऐसे एपीआई और एसडीके देखें जिन्हें Cloud Console में Maps API लाइब्रेरी पेज पर जाकर चालू किया जा सकता है:

    Maps API लाइब्रेरी के पेज पर जाएं

  2. उस एपीआई या SDK टूल पर क्लिक करें जिसे चालू करना है.
    • अगर बटन पर चालू करें लिखा है, तो एपीआई या SDK टूल को चालू करने के लिए बटन पर क्लिक करें.
    • अगर बटन पर मैनेज करें लिखा है, तो इसका मतलब है कि एपीआई या SDK पहले से ही चालू है और आपको कुछ करने की ज़रूरत नहीं है.
    • दोनों में से किसी भी बटन पर क्लिक करने से, एपीआई या SDK टूल का डैशबोर्ड दिखेगा. (इस प्रोजेक्ट से एपीआई या SDK टूल हटाने के लिए, बंद करें बटन पर क्लिक करें.)

Cloud SDK

नीचे दिया गया निर्देश, Maps, Routes, और Places के सभी एपीआई को चालू करता है:

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"

Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

Environment API चालू करने के लिए, इस निर्देश का इस्तेमाल करें:

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

तीसरा चरण

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

एपीआई पासकोड एक यूनीक आइडेंटिफ़ायर होता है. इसका इस्तेमाल, आपके प्रोजेक्ट से जुड़े अनुरोधों की पुष्टि करने के लिए किया जाता है. ऐसा, प्रोजेक्ट के इस्तेमाल और बिलिंग के लिए किया जाता है. आपके पास अपने प्रोजेक्ट से जुड़ी कम से कम एक एपीआई कुंजी होनी चाहिए.

एपीआई पासकोड बनाने के लिए:

कंसोल

  1. Google Maps Platform > क्रेडेंशियल पेज पर जाएं.

    क्रेडेंशियल पेज पर जाएं

  2. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
    एपीआई पासकोड बनाया गया डायलॉग बॉक्स में, आपका नया एपीआई पासकोड दिखता है.
  3. बंद करें पर क्लिक करें.
    नई एपीआई पासकोड, क्रेडेंशियल पेज पर एपीआई पासकोड में दिखती है.
    (प्रोडक्शन में इस्तेमाल करने से पहले, एपीआई पासकोड पर पाबंदी लगाना न भूलें.)

Cloud SDK

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

Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

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

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

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

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

  1. खाली व्यू वाली गतिविधि टेंप्लेट का इस्तेमाल करके, 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 डायरेक्ट्री में होती है. - वर्शन सेक्शन में, SDK टूल और 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 फ़ाइल बनाएं: - ऐप्लिकेशन मॉड्यूल की रूट डायरेक्ट्री में, 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 फ़ाइल की कुंजी से बदल देगा.

अगले चरण

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