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

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

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

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

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

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

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

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

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

  1. यहां बताए गए तरीके से, होस्ट Maven रिपॉज़िटरी को ऐक्सेस करने के लिए अपना एनवायरमेंट सेट अप करें इस गाइड का दूसरा चरण.

  2. अपने Gradle या Maven में उपभोक्ता SDK टूल और Maps SDK टूल की डिपेंडेंसी जोड़ना कॉन्फ़िगरेशन.

    नीचे दिए गए उदाहरणों में, VERSION_NUMBER को ज़रूरी वैल्यू से बदलें उपभोक्ता SDK टूल का मौजूदा वर्शन:

    ग्रेडल

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

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

    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>
    

अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना

अपने ऐप्लिकेशन में उपभोक्ता SDK टूल जोड़ने के बाद, एपीआई पासकोड जोड़ें. आपको विज्ञापनों को प्रोसेस करने के लिए, प्रोजेक्ट API पासकोड, जो आपको डेवलपमेंट प्रोजेक्ट सेट अप करते समय मिला था. इसके लिए ज़्यादा जानकारी के लिए, इस गाइड के तीसरे चरण में अपना डेवलपमेंट प्रोजेक्ट सेट अप करना देखें.

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

इस टास्क को आसान बनाने के लिए, GitHub के दस्तावेज़ Secrets Gradle का इस्तेमाल किया जा सकता है 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>

अपने ऐप्लिकेशन में ज़रूरी एट्रिब्यूशन शामिल करना

अगर आपके ऐप्लिकेशन में कंज़्यूमर SDK टूल का इस्तेमाल किया जाता है, तो आपको एट्रिब्यूशन टेक्स्ट और ओपन सोर्स लाइसेंस के बारे में ज़्यादा जानें. यह करना सबसे अच्छा है एट्रिब्यूशन को एक स्वतंत्र मेन्यू आइटम के तौर पर या इसके बारे में जानकारी के हिस्से के रूप में शामिल करना मेन्यू आइटम.

लाइसेंस की जानकारी, "third_party_ज़रूरी" में उपलब्ध है. फ़ाइल इन संग्रह से निकाली गई AAR फ़ाइल.

ज़्यादा जानकारी के लिए, https://developers.google.com/android/guides/opensource पर जाएं ओपन सोर्स नोटिस शामिल हैं.

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

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