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

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

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

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

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

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

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

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

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

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

ध्यान दें: उपभोक्ता 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 टूल जोड़ने के बाद, एपीआई पासकोड जोड़ें. आपको अपना डेवलपमेंट प्रोजेक्ट सेट अप करते समय मिली Project API कुंजी का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, इस गाइड के तीसरे चरण में अपना डेवलपमेंट प्रोजेक्ट सेट अप करना देखें.

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

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

प्लग इन इंस्टॉल करने और अपनी एपीआई कुंजी सेव करने के लिए:

अपनी रूट-लेवल 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 पर जाएं.

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

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