หน้านี้ได้รับการแปลโดย Cloud Translation API

กำหนดค่าโปรเจ็กต์ Google Cloud Console

วิธีตั้งค่าและกำหนดค่าโปรเจ็กต์ Google Cloud Console เพื่อใช้ Driver SDK สำหรับ Android ให้ทำตามขั้นตอนต่อไปนี้

ตั้งค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่
เพิ่ม Driver SDK ลงในแอป
เพิ่มคีย์ API ลงในแอป
ระบุแหล่งที่มาที่จำเป็นในแอป

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับแต่ละขั้นตอนในส่วนต่อไปนี้

ตั้งค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่ของคุณ

ส่วนนี้จะอธิบายวิธีกำหนดค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่สำหรับไดรเวอร์ SDK

ในการกำหนดค่าโปรเจ็กต์แอปบนอุปกรณ์เคลื่อนที่ ให้ทำตามขั้นตอนต่อไปนี้

หากไม่มีโปรเจ็กต์พัฒนา Google Cloud Console และคีย์ API สําหรับโปรเจ็กต์ระบบเคลื่อนที่ คุณจะต้องตั้งค่าขึ้นมา สำหรับข้อมูลเพิ่มเติม โปรดดู สร้างโปรเจ็กต์ 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 ของคุณ

หมายเหตุ: Driver SDK จะขึ้นอยู่กับ Navigation SDK ตั้งค่าการอ้างอิงเป็น เวอร์ชันที่กำหนดไว้อย่างชัดแจ้งของ Navigation SDK ดังที่แสดงในตัวอย่างนี้ ไม่เช่นนั้น ให้ข้ามโค้ดบล็อกตัวอย่างเพื่อเปิดใช้การดาวน์โหลดโปรเจ็กต์เสมอ Navigation SDK เวอร์ชันล่าสุดภายในเวอร์ชันหลักที่เผยแพร่ ลักษณะการทำงานรวมกันของ Driver SDK และ Navigation SDK เวอร์ชันล่าสุดมี ได้รับการทดสอบอย่างเข้มงวดก่อนเผยแพร่

ในตัวอย่างต่อไปนี้ ให้ใช้เวอร์ชันที่เลือกแทน 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 ที่ยกเลิกการเก็บ

โปรดดูวิธีรวมประกาศโอเพนซอร์ส รวมประกาศโอเพนซอร์ส

ขั้นตอนถัดไป

ประกาศทรัพยากร Dependency