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 जोड़ना

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

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

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

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

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