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

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

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

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

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

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

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

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

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

หมายเหตุ: 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 ได้ที่บทความแนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API ใน Google Maps Platform

หากต้องการเพิ่มประสิทธิภาพของงานนี้ คุณสามารถใช้เอกสารประกอบของ 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