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

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

नीचे दिए गए उदाहरण में, VERSION_NUMBER की जगह Driver SDK टूल के चुने गए वर्शन का इस्तेमाल करें.

ग्रेडल

अपने 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 पर मौजूद दस्तावेज़ 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 के साथ सिंक करें. ज़्यादा जानकारी के लिए, 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" फ़ाइल में देखी जा सकती है.

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

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

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