برای راهاندازی و پیکربندی پروژه Google Cloud Console برای استفاده از Driver SDK برای Android، این مراحل را دنبال کنید.
- پروژه برنامه تلفن همراه خود را تنظیم کنید .
- Driver SDK را به برنامه خود اضافه کنید .
- کلید API را به برنامه خود اضافه کنید .
- اسناد مورد نیاز را در برنامه خود قرار دهید .
برای جزئیات بیشتر در مورد هر مرحله، بخش های زیر را ببینید.
پروژه اپلیکیشن موبایل خود را تنظیم کنید
این بخش نحوه پیکربندی پروژه برنامه تلفن همراه خود را برای Driver SDK توضیح می دهد.
برای پیکربندی پروژه اپلیکیشن موبایل خود، این مراحل را دنبال کنید:
- اگر پروژه توسعه Google Cloud Console و کلید API برای پروژه تحرک خود ندارید، باید یکی را تنظیم کنید. برای اطلاعات بیشتر، به ایجاد پروژه Fleet Engine خود مراجعه کنید.
- در Google Cloud Console، همان پروژه Google Cloud Console و کلید API را که برای Fleet Engine استفاده میکنید، انتخاب کنید.
- APIs & Services را انتخاب کنید و Maps SDK for Android را جستجو و فعال کنید.
Driver SDK را به برنامه خود اضافه کنید
Driver SDK از مخزن Google Maven در دسترس است. این مخزن شامل فایلهای Project Object Model (.pom) SDK و 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'
}
ماون
موارد زیر را به 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>
کلید API را به برنامه خود اضافه کنید
هنگامی که Driver SDK را به برنامه خود اضافه کردید، کلید API را اضافه کنید. شما باید از کلید API پروژه ای که هنگام راه اندازی پروژه توسعه خود به دست آورده اید استفاده کنید. برای جزئیات بیشتر، به تنظیم پروژه برنامه تلفن همراه خود مراجعه کنید.
این بخش نحوه ذخیره کلید API خود را توضیح می دهد تا بتواند با امنیت بیشتری توسط برنامه شما ارجاع دهد. برای اطلاعات بیشتر در مورد بهترین شیوه های امنیتی کلید API، مقاله پلتفرم نقشه های Google را در مورد بهترین شیوه های امنیتی API ببینید.
برای سادهسازی این کار، میتوانید از افزونه Secrets Gradle اسناد GitHub برای اندروید استفاده کنید.
برای نصب افزونه و ذخیره کلید API خود، مراحل زیر را دنبال کنید:
فایل
build.gradle
سطح ریشه خود را باز کنید و کد زیر را به عنصرdependencies
در زیرbuildscript
اضافه کنید.شیار
buildscript { dependencies { // ... classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0" } }
کاتلین
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'
کاتلین
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
اگر از Android Studio استفاده می کنید، پروژه خود را با Gradle همگام کنید. برای جزئیات، به همگام سازی پروژه خود با Gradle مراجعه کنید.
local.properties
در دایرکتوری سطح پروژه خود باز کنید و کد زیر را اضافه کنید. کلید API خود را جایگزین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_licenses.txt" در فایل AAR بایگانی نشده بیابید.
در مورد نحوه گنجاندن اعلامیه های منبع باز به درج اعلان های منبع باز مراجعه کنید.