Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

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

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

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

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

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

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

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

ग्रेडल

अपनी build.gradle में यह जोड़ें:

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

Maven

अपने pom.xml में यह जोड़ें:

<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 का इस्तेमाल किया जा सकता है.

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

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

ग्रूवी

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")
    }
}

ऐप्लिकेशन-लेवल की build.gradle फ़ाइल खोलें और plugins एलिमेंट में यह कोड जोड़ें.
ग्रूवी
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
अगर Android Studio का इस्तेमाल किया जाता है, तो अपने प्रोजेक्ट को Gradle के साथ सिंक करें. ज़्यादा जानकारी के लिए, Android के दस्तावेज़ में अपने प्रोजेक्ट को Gradle के साथ सिंक करना लेख पढ़ें.
अपने प्रोजेक्ट लेवल की डायरेक्ट्री में local.properties खोलें. इसके बाद, यह कोड जोड़ें. YOUR_API_KEY को अपने एपीआई पासकोड से बदलें.

MAPS_API_KEY=YOUR_API_KEY
अपनी 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 पर जाएं.

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

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