Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना

Android के लिए Consumer SDK का इस्तेमाल करने के लिए, Google Cloud Console को सेट अप और कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं.

1. अपना डेवलपमेंट प्रोजेक्ट सेट अप करें.
2. अपने ऐप्लिकेशन में Consumer SDK जोड़ें.
3. अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ें.
4. अपने ऐप्लिकेशन में ज़रूरी एट्रिब्यूशन शामिल करें.

हर चरण के बारे में ज़्यादा जानने के लिए, यहां दिए गए सेक्शन देखें.

अपना डेवलपमेंट प्रोजेक्ट सेट अप करना

अगर आपके पास, मोबिलिटी प्रोजेक्ट के लिए Google Cloud Console का डेवलपमेंट प्रोजेक्ट और एपीआई पासकोड नहीं है, तो आपको इसे सेट अप करना होगा. ज़्यादा जानकारी के लिए, Fleet Engine की गाइड में अपना प्रोजेक्ट बनाना लेख पढ़ें.

Consumer SDK के लिए अपना डेवलपमेंट प्रोजेक्ट चुनते समय, उसी Google Cloud Console प्रोजेक्ट और एपीआई पासकोड को चुनें जिसका इस्तेमाल Fleet Engine के लिए किया जा रहा है.

अपने ऐप्लिकेशन में Consumer SDK जोड़ना

Consumer SDK, Google Maven रिपॉज़िटरी से उपलब्ध है. इस रिपॉज़िटरी में, एसडीके की प्रोजेक्ट ऑब्जेक्ट मॉडल (.pom) फ़ाइलें और Javadocs शामिल हैं. अपने ऐप्लिकेशन में Consumer SDK जोड़ने के लिए, अपने Gradle या Maven कॉन्फ़िगरेशन में Consumer SDK और Maps SDK की डिपेंडेंसी जोड़ें.

यहां दिए गए उदाहरणों में, VERSION_NUMBER को Consumer SDK के ज़रूरी वर्शन से बदलें:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना

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

इस सेक्शन में, एपीआई पासकोड को सेव करने का तरीका बताया गया है, ताकि आपका ऐप्लिकेशन इसे ज़्यादा सुरक्षित तरीके से रेफ़र कर सके. एपीआई पासकोड की सुरक्षा से जुड़े सबसे सही तरीकों के बारे में ज़्यादा जानने के लिए, Google Maps Platform का एपीआई सुरक्षा से जुड़े सबसे सही तरीके लेख पढ़ें.

इस टास्क को आसान बनाने के लिए, GitHub के दस्तावेज़ में दिया गया Secrets Gradle Plugin for Android इस्तेमाल किया जा सकता है.

प्लग-इन इंस्टॉल करने और एपीआई पासकोड सेव करने के लिए:

1. अपनी रूट-लेवल की build.gradle फ़ाइल खोलें और buildscript में मौजूद dependencies एलिमेंट में यह कोड जोड़ें.

   Groovy

   buildscript {
         dependencies {
             // ...
             classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
         }
   }
   

   Kotlin

   buildscript {
       dependencies {
           // ...
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
       }
   }
   

2. अपने ऐप्लिकेशन-लेवल की build.gradle फ़ाइल खोलें और plugins एलिमेंट में यह कोड जोड़ें.

   Groovy

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Kotlin

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. अगर Android Studio का इस्तेमाल किया जा रहा है, तो अपने प्रोजेक्ट को Gradle के साथ सिंक करें. ज़्यादा जानकारी के लिए, Android के दस्तावेज़ में अपने प्रोजेक्ट को Gradle के साथ सिंक करना लेख पढ़ें.

4. अपने प्रोजेक्ट-लेवल की डायरेक्ट्री में मौजूद local.properties फ़ाइल खोलें. इसके बाद, यह कोड जोड़ें. YOUR_API_KEY को अपने एपीआई पासकोड से बदलें.

   MAPS_API_KEY=YOUR_API_KEY

5. अपनी AndroidManifest.xml फ़ाइल में, com.google.android.geo.API_KEY पर जाएं और android:value एट्रिब्यूट को इस तरह अपडेट करें:

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

यहां दिए गए उदाहरण में, सैंपल ऐप्लिकेशन के लिए पूरा मेनिफ़ेस्ट दिखाया गया है:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme">

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

            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

अपने ऐप्लिकेशन में ज़रूरी एट्रिब्यूशन शामिल करना

अगर अपने ऐप्लिकेशन में Consumer SDK का इस्तेमाल किया जाता है, तो आपको अपने ऐप्लिकेशन के कानूनी नोटिस वाले सेक्शन में, एट्रिब्यूशन टेक्स्ट और ओपन सोर्स लाइसेंस शामिल करने होंगे. सबसे सही तरीका है कि एट्रिब्यूशन को, मेन्यू के किसी अलग आइटम के तौर पर या जानकारी वाले मेन्यू आइटम के हिस्से के तौर पर शामिल किया जाए.

लाइसेंस की जानकारी, अनआर्काइव की गई AAR फ़ाइल में मौजूद "third_party_licenses.txt" फ़ाइल में देखी जा सकती है.

ओपन सोर्स नोटिस शामिल करने के तरीके के बारे में जानने के लिए, https://developers.google.com/android/guides/opensource पर जाएं.

आगे क्या करना है

पुष्टि करने वाले टोकन पाना