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

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

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

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

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

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

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

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

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

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

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

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

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

<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 के दस्तावेज़ में मौजूद Android के लिए सीक्रेट ग्रेडल प्लग इन का इस्तेमाल किया जा सकता है.

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

1. रूट-लेवल की build.gradle फ़ाइल खोलें और buildscript में मौजूद dependencies एलिमेंट में यह कोड जोड़ें.

   Groovy

   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 एलिमेंट में यह कोड जोड़ें.

   Groovy

   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>

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

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

आपको लाइसेंस की जानकारी, अनआर्काइव की गई AAR फ़ाइल में मौजूद "third_party_licenses.txt" फ़ाइल में मिलेगी.

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

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

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