इस पेज का अनुवाद Cloud Translation API से किया गया है.

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 कॉन्फ़िगरेशन में जोड़ें.

ध्यान दें: Consumer SDK, Maps SDK पर निर्भर करता है. Maps SDK टूल के साफ़ तौर पर तय किए गए वर्शन पर अपनी डिपेंडेंसी सेट करें. उदाहरण के लिए, यहां दिया गया तरीका अपनाएं. अगर ऐसा नहीं किया जाता है, तो Consumer SDK, Maps SDK के ज़रूरी वर्शन का इस्तेमाल करता है. इससे समस्याएं हो सकती हैं. ऐसा तब होता है, जब आपका ऐप्लिकेशन Maps SDK के बाद के वर्शन में उपलब्ध सुविधाओं पर निर्भर करता है.

यहां दिए गए उदाहरणों में, 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 के दस्तावेज़ 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 पर जाएं.

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

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