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. एपीआई और सेवाएं को चुनें. इसके बाद, Maps SDK for Android को खोजें और चालू करें.

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

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

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

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

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

  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" फ़ाइल में मिल सकती है.

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

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

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