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

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

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

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

मोबाइल ऐप्लिकेशन प्रोजेक्ट सेट अप करना

इस सेक्शन में, ड्राइवर एसडीके के लिए मोबाइल ऐप्लिकेशन प्रोजेक्ट को कॉन्फ़िगर करने का तरीका बताया गया है.

अपने मोबाइल ऐप्लिकेशन प्रोजेक्ट को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

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

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

ड्राइवर एसडीके, Google Maven रिपॉज़िटरी में उपलब्ध है. रिपॉज़िटरी में, एसडीके की प्रोजेक्ट ऑब्जेक्ट मॉडल (.pom) फ़ाइलें और Javadocs शामिल होते हैं.

अपने ऐप्लिकेशन में Driver SDK जोड़ने के लिए, Gradle या Maven कॉन्फ़िगरेशन में Driver SDK और Navigation SDK की डिपेंडेंसी जोड़ें.

यहां दिए गए उदाहरण में, VERSION_NUMBER को ड्राइवर एसडीके के चुने गए वर्शन से बदलें.

ग्रेडल

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

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

अपनी pom.xml में यह जोड़ें:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

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

अपने ऐप्लिकेशन में Driver 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 के साथ सिंक करें. ज़्यादा जानकारी के लिए, अपने प्रोजेक्ट को 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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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>

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

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

लाइसेंस की जानकारी, अनआर्काइव की गई एएआर फ़ाइल में मौजूद "third_party_licenses.txt" फ़ाइल में देखी जा सकती है.

ओपन सोर्स की सूचनाएं शामिल करने के तरीके के बारे में जानने के लिए, ओपन सोर्स की सूचनाएं शामिल करें लेख पढ़ें.

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

डिपेंडेंसी का एलान करना