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

หากต้องการตั้งค่าและกำหนดค่าโปรเจ็กต์คอนโซล 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) และ Javadoc ของ 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 ได้ที่บทความแนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API ใน Google Maps Platform เรื่อง แนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API

หากต้องการลดความซับซ้อนของงานนี้ คุณสามารถใช้ปลั๊กอินข้อมูลลับ Gradle สำหรับ Android ในเอกสารประกอบของ GitHub

หากต้องการติดตั้งปลั๊กอินและจัดเก็บคีย์ API ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดไฟล์ build.gradle ระดับราก แล้วเพิ่มโค้ดต่อไปนี้ลงในองค์ประกอบ dependencies ภายใต้ buildscript

   Groovy

   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

   Groovy

   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