सेटअप

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (pre-GA). हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको पूरी सहायता न मिले. साथ ही, ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर, Google Maps Platform की सेवा से जुड़ी खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

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

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

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

पहला चरण

कंसोल

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

• gcloud projects create

ध्यान दें: अगर आपको सीखने के लिए किए जाने वाले किसी टास्क में बनाए गए संसाधन सेव नहीं करने हैं, तो मौजूदा प्रोजेक्ट चुनने के बजाय एक नया प्रोजेक्ट बनाएं. टास्क पूरा होने के बाद, प्रोजेक्ट को मिटाया जा सकता है. इससे प्रोजेक्ट से जुड़े सभी संसाधन हट जाएंगे.

दूसरा चरण

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

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

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

कंसोल

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

   Maps API Library पेज पर जाएं

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
• gcloud services disable

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

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

ध्यान दें: Places API को चालू करने पर, Places Library, Maps JavaScript API, Android के लिए Places SDK, और iOS के लिए Places SDK भी चालू हो जाते हैं.

तीसरा चरण

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

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

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

कंसोल

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

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

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

Cloud SDK

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

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

• gcloud services api-keys create

एसडीके को चालू करने के लिए, 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.2"
   # 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
   

   ध्यान दें: पक्का करें कि आपने YOUR_API_KEY_HERE की जगह, वह एपीआई पासकोड डाला हो जिसे Android के लिए Maps 3D SDK के साथ इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है.

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 फ़ाइल से पासकोड डाल देगा.

प्रोग्राम के ज़रिए व्यू को शुरू करना (ज़रूरी नहीं)

अगर आपको एक्सएमएल लेआउट के बजाय, प्रोग्राम के ज़रिए मैप व्यू शुरू करना है, तो Map3DInitConfig का इस्तेमाल करें.

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

अगले चरण

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