設定 Google Cloud 控制台專案

如要設定及配置 Google Cloud 主控台專案，以便使用 Driver SDK for Android，請按照下列步驟操作。

1. 設定行動應用程式專案。
2. 在應用程式中加入 Driver SDK。
3. 在應用程式中加入 API 金鑰。
4. 在應用程式中加入必要的版權聲明。

如要進一步瞭解每個步驟，請參閱以下各節。

注意： 應用程式必須指定 minSdkVersion 23 以上版本。

設定行動應用程式專案

本節說明如何為 Driver SDK 設定行動應用程式專案。

如要設定行動應用程式專案，請按照下列步驟操作：

1. 如果您沒有 Google Cloud 控制台開發專案和行動專案的 API 金鑰，就需要設定這兩項項目。詳情請參閱「建立 Fleet Engine 專案」一文。
2. 在 Google Cloud 控制台中，選取與 Fleet Engine 相同的 Google Cloud 控制台專案和 API 金鑰。
3. 選取「API 和服務」，然後搜尋並啟用 Maps SDK for Android。

在應用程式中加入 Driver SDK

您可以從 Google Maven 存放區取得 Driver SDK。存放區包含 SDK 的 Project Object Model (.pom) 檔案和 Javadoc。

如要將 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 金鑰安全性最佳做法，請參閱 Google 地圖平台的「API 安全性最佳做法」一文。

重要事項： 請勿在版本管控系統中登錄 API 金鑰。請改為將其儲存在專案根目錄中的 local.properties 檔案中。如要進一步瞭解 local.properties 檔案，請參閱 這篇文章中關於 Gradle 屬性檔案的說明。

您可以使用 GitHub 說明文件 Secrets Gradle Plugin for Android 來簡化這項工作。

如要安裝外掛程式並儲存 API 金鑰，請按照下列步驟操作：

1. 開啟根層級的 build.gradle 檔案，然後將下列程式碼加進 buildscript 下方的 dependencies 元素。

   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 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>

注意： 為獲得最佳導航體驗，駕駛人應授予以下權限：android.permission.ACCESS_COARSE_LOCATION 和 android.permission.ACCESS_FINE_LOCATION。請務必在應用程式中於執行階段要求這兩項權限。

在應用程式中加入必要的版權聲明

如果您在應用程式中使用 Driver SDK，就必須在應用程式的法律聲明部分中加入出處資訊文字和開放原始碼授權。建議將版權聲明設為獨立的選單項目，或是加進「關於」選單項目的內容中。

您可以在未封存的 AAR 檔案中，找到「third_party_licenses.txt」檔案中的授權資訊。

如要瞭解如何加入開放原始碼聲明，請參閱「加入開放原始碼聲明」。

後續步驟

宣告依附元件