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 रिपॉज़िटरी से उपलब्ध है. इस रिपॉज़िटरी में, SDK टूल के प्रोजेक्ट ऑब्जेक्ट मॉडल (.pom) फ़ाइलें और Javadocs शामिल होते हैं. अपने ऐप्लिकेशन में Consumer SDK टूल जोड़ने के लिए, अपने Gradle या Maven कॉन्फ़िगरेशन में Consumer 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 के लिए Secrets Gradle प्लग इन का इस्तेमाल किया जा सकता है.

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

  1. रूट-लेवल की 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")
    }
}

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

    ग्रूवी

    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 पर जाएं.

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

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