सेटअप

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

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

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

चरण 1

कंसोल

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

दूसरा चरण

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

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

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

कंसोल

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

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

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

Cloud SDK

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

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 इंस्टॉल करने , और इन कमांड के बारे में ज़्यादा जानें:

एनवायरमेंट एपीआई चालू करने के लिए, इस निर्देश का इस्तेमाल करें:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.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 इंस्टॉल करने , और इन कमांड के बारे में ज़्यादा जानें:

एसडीके चालू करने के लिए, 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 डायरेक्ट्री में होती है.
    • वर्शन सेक्शन में, एसडीके और Secrets Gradle प्लगिन के वर्शन जोड़ें:
    maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"
    • लाइब्रेरी सेक्शन में, एसडीके टूल की लाइब्रेरी जोड़ें:
    play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
    • प्लगिन सेक्शन में, 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 डायरेक्ट्री में मौजूद होती है.
    • फ़ाइल में सबसे ऊपर, Secrets Gradle प्लगिन को plugins ब्लॉक में जोड़ें:
    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 Plugin, ${MAPS3D_API_KEY} प्लेसहोल्डर को आपकी secrets.properties फ़ाइल में मौजूद कुंजी से बदल देगा.

अगले चरण

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