วิธีตั้งค่าและกำหนดค่าโปรเจ็กต์ Google Cloud Console เพื่อใช้ Driver SDK สำหรับ Android ให้ทำตามขั้นตอนต่อไปนี้
- ตั้งค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่
- เพิ่ม Driver SDK ลงในแอป
- เพิ่มคีย์ API ลงในแอป
- ระบุแหล่งที่มาที่จำเป็นในแอป
โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับแต่ละขั้นตอนในส่วนต่อไปนี้
ตั้งค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่ของคุณ
ส่วนนี้จะอธิบายวิธีกำหนดค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่สำหรับไดรเวอร์ SDK
ในการกำหนดค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่ ให้ทำตามขั้นตอนต่อไปนี้
- หากไม่มีโปรเจ็กต์การพัฒนาคอนโซล Google Cloud และคีย์ API คุณต้องสร้างขึ้นมา 1 ชิ้นสำหรับโปรเจ็กต์ระบบเคลื่อนที่ สำหรับข้อมูลเพิ่มเติม โปรดดู สร้างโปรเจ็กต์ Fleet Engine
- ใน Google Cloud Console ให้เลือกโปรเจ็กต์คอนโซล Google Cloud เดียวกันและ คีย์ API ที่คุณใช้สำหรับ Fleet Engine
- เลือก API และ บริการแล้วค้นหาและเปิดใช้ Maps SDK สำหรับ Android
เพิ่ม Driver SDK ลงในแอปของคุณ
Driver SDK พร้อมให้ใช้งานจากที่เก็บของ Google Maven ที่เก็บ มีไฟล์ Project Object Model (.pom) ของ SDK และ Javadocs
หากต้องการเพิ่ม Driver SDK ลงในแอป ให้เพิ่ม Driver SDK และ Navigation SDK ทรัพยากร Dependency สำหรับการกำหนดค่า Gradle หรือ Maven ของคุณ
ในตัวอย่างต่อไปนี้ ให้ใช้เวอร์ชันที่เลือกแทน VERSION_NUMBER
ของ Driver SDK
Gradle
เพิ่มสิ่งต่อไปนี้ใน 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>
เพิ่มคีย์ API ลงในแอป
เมื่อเพิ่ม Driver SDK ลงในแอปแล้ว ให้เพิ่มคีย์ API คุณต้องใช้ คีย์ API ของโปรเจ็กต์ที่คุณได้รับเมื่อคุณตั้งค่าโปรเจ็กต์การพัฒนา สำหรับ ดูรายละเอียดเพิ่มเติมได้ที่ตั้งค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่
ส่วนนี้จะอธิบายวิธีจัดเก็บคีย์ API เพื่อให้ปลอดภัยยิ่งขึ้น ที่แอปของคุณอ้างอิง ดูข้อมูลเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติแนะนำด้านความปลอดภัยสำหรับคีย์ API ดูบทความ Google Maps Platform เกี่ยวกับแนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API
คุณสามารถใช้เอกสารของ GitHub เพื่อเพิ่มประสิทธิภาพงานนี้ ปลั๊กอินข้อมูลลับ Gradle สำหรับ Android
หากต้องการติดตั้งปลั๊กอินและจัดเก็บคีย์ API ให้ทำตามขั้นตอนต่อไปนี้
เปิดไฟล์
build.gradle
ระดับรากและเพิ่มโค้ดต่อไปนี้ลงในส่วนdependencies
องค์ประกอบภายใต้buildscript
ดึงดูด
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
ด้วยคีย์ APIMAPS_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 ที่สมบูรณ์สำหรับแอปตัวอย่าง
<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 ที่ยกเลิกการเก็บ
โปรดดูวิธีรวมประกาศโอเพนซอร์ส รวมประกาศโอเพนซอร์ส