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

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

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

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

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

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

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

1. หากไม่มีโปรเจ็กต์การพัฒนาคอนโซล Google Cloud และคีย์ API สำหรับโปรเจ็กต์อุปกรณ์เคลื่อนที่ คุณจะต้องสร้างโปรเจ็กต์และคีย์ สำหรับข้อมูลเพิ่มเติม โปรดดู สร้างโปรเจ็กต์ Fleet Engine
2. ในคอนโซล Google Cloud ให้เลือกโปรเจ็กต์คอนโซล Google Cloud และคีย์ API เดียวกันกับที่ใช้สำหรับ Fleet Engine
3. เลือก API และ บริการแล้วค้นหาและเปิดใช้ Maps SDK สำหรับ Android

เพิ่ม Driver SDK ลงในแอปของคุณ

Driver SDK พร้อมให้ใช้งานจากที่เก็บของ Google Maven พื้นที่เก็บข้อมูลจะรวมไฟล์ Project Object Model (.pom) และ Javadoc ของ SDK

หากต้องการเพิ่ม Driver SDK ลงในแอป ให้เพิ่ม Driver SDK และ Navigation SDK ทรัพยากร Dependency สำหรับการกำหนดค่า Gradle หรือ Maven ของคุณ

ในตัวอย่างต่อไปนี้ ให้ใช้เวอร์ชันที่เลือกแทน VERSION_NUMBER ของ Driver SDK

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

<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 ให้ทําตามขั้นตอนต่อไปนี้

1. เปิดไฟล์ 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")
       }
   }
   

2. เปิดไฟล์ build.gradle ระดับแอปและเพิ่มโค้ดต่อไปนี้ลงใน องค์ประกอบ plugins

   ดึงดูด

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Kotlin

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. หากคุณใช้ Android Studio ให้ซิงค์โปรเจ็กต์กับ Gradle โปรดดูรายละเอียดที่หัวข้อซิงค์โปรเจ็กต์กับ Gradle

4. เปิด local.properties ในไดเรกทอรีระดับโปรเจ็กต์แล้วเพิ่ม รหัสต่อไปนี้ แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ

   MAPS_API_KEY=YOUR_API_KEY

5. ในไฟล์ 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