ड्राइवर SDK टूल का इस्तेमाल करने के लिए, Google Cloud Console प्रोजेक्ट को सेट अप और कॉन्फ़िगर करने के लिए Android के लिए, यह तरीका अपनाएं.
- अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट सेट अप करें.
- अपने ऐप्लिकेशन में Driver SDK टूल जोड़ें.
- अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ें.
- अपने ऐप्लिकेशन में ज़रूरी एट्रिब्यूशन शामिल करें.
हर चरण के बारे में ज़्यादा जानकारी के लिए, नीचे दिए गए सेक्शन देखें.
अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट सेट अप करना
इस सेक्शन में, Driver SDK के लिए अपने मोबाइल ऐप्लिकेशन प्रोजेक्ट को कॉन्फ़िगर करने का तरीका बताया गया है.
अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:
- अगर आपके पास अपने मोबिलिटी प्रोजेक्ट के लिए, Google Cloud Console का डेवलपमेंट प्रोजेक्ट और एपीआई पासकोड नहीं है, तो आपको एक सेट अप करना होगा. ज़्यादा जानकारी के लिए, यह देखें अपना Fleet Engine प्रोजेक्ट बनाएं.
- Google Cloud Console में, वही Google Cloud Console प्रोजेक्ट और एपीआई पासकोड चुनें जिसका इस्तेमाल Fleet Engine के लिए किया जा रहा है.
- चुनें एपीआई और सेवाएं ढूंढें और Android के लिए Maps SDK टूल.
अपने ऐप्लिकेशन में ड्राइवर SDK टूल जोड़ना
Driver SDK, Google Maven रिपॉज़िटरी से उपलब्ध है. इस रिपॉज़िटरी में, SDK टूल के प्रोजेक्ट ऑब्जेक्ट मॉडल (.pom) फ़ाइलें और Javadocs शामिल होते हैं.
अपने ऐप्लिकेशन में ड्राइवर SDK टूल जोड़ने के लिए, ड्राइवर SDK टूल और नेविगेशन 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 के लिए Secrets Gradle प्लग इन का इस्तेमाल किया जा सकता है.
प्लग इन इंस्टॉल करने और अपनी एपीआई कुंजी सेव करने के लिए, यह तरीका अपनाएं:
अपनी रूट-लेवल
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") } }
अपनी ऐप्लिकेशन-लेवल की
build.gradle
फ़ाइल खोलें और यहां दिए गए कोड कोplugins
एलिमेंट.ग्रूवी
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Android Studio का इस्तेमाल करने पर, अपने प्रोजेक्ट को Gradle के साथ सिंक करें. ज़्यादा जानकारी के लिए, अपने प्रोजेक्ट को Gradle के साथ सिंक करना लेख पढ़ें.
local.properties
को अपनी प्रोजेक्ट लेवल की डायरेक्ट्री में खोलें. इसके बाद, जोड़ें है.YOUR_API_KEY
को अपनी एपीआई पासकोड से बदलें.MAPS_API_KEY=YOUR_API_KEY
अपनी
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 टूल का इस्तेमाल किया है, तो आपको अपने ऐप्लिकेशन के कानूनी नोटिस सेक्शन में, एट्रिब्यूशन टेक्स्ट और ओपन सोर्स लाइसेंस शामिल करने होंगे. एट्रिब्यूशन को अलग मेन्यू आइटम के तौर पर या इसके बारे में जानकारी वाले मेन्यू आइटम के हिस्से के तौर पर शामिल करना सबसे अच्छा होता है.
लाइसेंस की जानकारी, "third_party_ प्रमोशन.txt" में देखी जा सकती है फ़ाइल संग्रह से निकाली गई AAR फ़ाइल.
ओपन सोर्स सूचनाएं शामिल करना देखें और जानें कि ओपन सोर्स नोटिस शामिल हैं.