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

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

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

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

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

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

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

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

เพิ่ม Driver SDK ลงในแอป

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

หากต้องการเพิ่ม Driver SDK ลงในแอป ให้เพิ่มทรัพยากร Dependency ของ Driver SDK และ Navigation SDK ลงในการกำหนดค่า 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

คุณสามารถใช้ปลั๊กอินข้อมูลลับ Gradle สำหรับ Android ในเอกสารประกอบของ GitHub เพื่อปรับปรุงงานนี้ให้มีประสิทธิภาพยิ่งขึ้น

หากต้องการติดตั้งปลั๊กอินและจัดเก็บคีย์ 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