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