Android के लिए Driver SDK टूल का इस्तेमाल करने के लिए, Google Cloud कंसोल प्रोजेक्ट को सेट अप और कॉन्फ़िगर करने का तरीका यहां बताया गया है.
- अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट सेट अप करें.
- अपने ऐप्लिकेशन में Driver SDK टूल जोड़ें.
- अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ें.
- अपने ऐप्लिकेशन में ज़रूरी एट्रिब्यूशन शामिल करें.
हर चरण के बारे में ज़्यादा जानकारी के लिए, नीचे दिए गए सेक्शन देखें.
अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट सेट अप करना
इस सेक्शन में, Driver SDK के लिए अपने मोबाइल ऐप्लिकेशन प्रोजेक्ट को कॉन्फ़िगर करने का तरीका बताया गया है.
अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:
- अगर आपके पास अपने मोबाइल प्रोजेक्ट के लिए, Google Cloud कंसोल डेवलपमेंट प्रोजेक्ट और एपीआई पासकोड नहीं है, तो आपको एक सेट अप करना होगा. ज़्यादा जानकारी के लिए, Fleet Engine प्रोजेक्ट बनाना लेख पढ़ें.
- Google Cloud Console में, वही Google Cloud Console प्रोजेक्ट और एपीआई पासकोड चुनें जिसका इस्तेमाल आपने Fleet Engine के लिए किया है.
- एपीआई और सेवाएं चुनें. इसके बाद, Maps SDK for Android को खोजें और चालू करें.
अपने ऐप्लिकेशन में Driver SDK टूल जोड़ना
Driver SDK, Google Maven रिपॉज़िटरी से उपलब्ध है. इस रिपॉज़िटरी में, एसडीके के प्रोजेक्ट ऑब्जेक्ट मॉडल (.pom) फ़ाइलें और Javadoc शामिल होते हैं.
अपने ऐप्लिकेशन में 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 टूल जोड़ने के बाद, API key जोड़ें. आपको उस प्रोजेक्ट एपीआई पासकोड का इस्तेमाल करना होगा जो आपको डेवलपमेंट प्रोजेक्ट सेट अप करते समय मिला था. ज़्यादा जानकारी के लिए, अपना मोबाइल ऐप्लिकेशन प्रोजेक्ट सेट अप करना देखें.
इस सेक्शन में, एपीआई पासकोड को सेव करने का तरीका बताया गया है, ताकि आपका ऐप्लिकेशन उसे ज़्यादा सुरक्षित तरीके से इस्तेमाल कर सके. एपीआई पासकोड की सुरक्षा के सबसे सही तरीकों के बारे में ज़्यादा जानने के लिए, एपीआई की सुरक्षा के सबसे सही तरीकों के बारे में 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 टूल का इस्तेमाल किया है, तो आपको अपने ऐप्लिकेशन के कानूनी नोटिस सेक्शन में एट्रिब्यूशन टेक्स्ट और ओपन सोर्स लाइसेंस शामिल करने होंगे. एट्रिब्यूशन को अलग मेन्यू आइटम के तौर पर या इसके बारे में जानकारी वाले मेन्यू आइटम के हिस्से के तौर पर शामिल करना सबसे अच्छा होता है.
लाइसेंस की जानकारी, अनअर्काइव की गई AAR फ़ाइल में "third_party_licenses.txt" फ़ाइल में मिल सकती है.
ओपन सोर्स की सूचनाएं शामिल करने का तरीका जानने के लिए, ओपन सोर्स की सूचनाएं शामिल करना लेख पढ़ें.