วิธีตั้งค่าและกำหนดค่าโปรเจ็กต์ Google Cloud Console เพื่อใช้ Driver SDK สำหรับ Android ให้ทำตามขั้นตอนต่อไปนี้
- สร้างโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่
- เพิ่ม Driver SDK ลงในแอป
- เพิ่มคีย์ API ลงในแอป
- ระบุแหล่งที่มาที่จำเป็นในแอป
โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับแต่ละขั้นตอนในส่วนต่อไปนี้
ตั้งค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่
ส่วนนี้จะอธิบายวิธีกำหนดค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่สำหรับ Driver SDK
ในการกำหนดค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่ ให้ทำตามขั้นตอนต่อไปนี้
- หากไม่มีโปรเจ็กต์การพัฒนาคอนโซล Google Cloud และคีย์ API สําหรับโปรเจ็กต์ระบบเคลื่อนที่ คุณจะต้องตั้งค่าขึ้นมา สำหรับข้อมูลเพิ่มเติม โปรดดู สร้างโปรเจ็กต์ Fleet Engine
- ใน Google Cloud Console ให้เลือกโปรเจ็กต์คอนโซล Google Cloud เดียวกันและ คีย์ API ที่คุณใช้สำหรับ Fleet Engine
- เลือก API และ บริการแล้วค้นหาและเปิดใช้ Maps SDK สำหรับ Android
เพิ่ม Driver SDK ลงในแอป
Driver SDK มีให้บริการจากที่เก็บ Maven ของ Google ที่เก็บ มีไฟล์ 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 ที่ยกเลิกการเก็บ
โปรดดูวิธีใส่ประกาศโอเพนซอร์ส