設定並設定 Google Cloud 控制台,以便將 Consumer SDK 用於 在 Android 裝置上,按照下列步驟操作。
如要進一步瞭解每個步驟,請參閱下列章節。
設定開發專案
如果您沒有 Google Cloud 控制台開發專案,也沒有 則需要設定一個行動專案。詳情請參閱 參閱 Fleet Engine 指南中的建立專案。
為 Consumer SDK 選取開發專案時,請選取 您用於 Fleet Engine 的 Google Cloud 控制台專案和 API 金鑰。
在應用程式中加入 Consumer SDK
Consumer SDK 是從私人 Maven 存放區取得。存放區 包括 SDK 的專案物件模型 (.pom) 檔案和 Javadocs。如要新增 呼叫應用程式的消費者 SDK,請按照下列步驟操作:
按照下列說明設定環境以存取主機 Maven 存放區 本指南的步驟 2。
在 Gradle 或 Maven 中加入 Consumer SDK 和 Maps SDK 依附元件 此外還會從 0 自動調整資源配置 您完全不必調整資源調度設定
在下方範例中,將
VERSION_NUMBER
替換成必要的值 專用的 Consumer SDK 版本Gradle
請將以下內容新增到您的
build.gradle
中:dependencies { ... implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER' implementation "com.google.android.gms:play-services-maps:VERSION_NUMBER" }
Maven
請將以下內容新增到您的
pom.xml
中:<dependencies> ... <dependency> <groupId>com.google.android.libraries.mapsplatform.transportation</groupId> <artifactId>transportation-consumer</artifactId> <version>VERSION_NUMBER</version> </dependency> <dependency> <groupId>com.google.android.gms</groupId> <artifactId>play-services-maps</artifactId> <version>18.1.0</version> </dependency> </dependencies>
在應用程式中加入 API 金鑰
將 Consumer SDK 新增至應用程式後,請新增 API 金鑰。您必須使用 您在設定開發專案時取得的專案 API 金鑰。適用對象 詳情請參閱本指南步驟 3 的「設定開發專案」一節。
本節說明如何儲存 API 金鑰,讓金鑰更安全 由您的應用程式參照。如要進一步瞭解 API 金鑰安全性最佳做法, 請參閱有關 API 安全性最佳做法的 Google 地圖平台文章。
您可以參考 GitHub 說明文件「Secrets Gradle」來簡化這項工作 適用於 Android 的外掛程式。
如要安裝這個外掛程式並儲存 API 金鑰,請按照下列步驟操作:
開啟根層級的
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") } }
開啟應用程式層級的
build.gradle
檔案,然後將下列程式碼加進plugins
元素。Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
如果您使用 Android Studio,請將專案與 Gradle 同步處理。詳情請參閱 在 Android 說明文件中,將專案與 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 xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.consumerapidemo">
<uses-permission android:name="android.permission.ACCESS_FINE_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>
在應用程式中加入必要的作者資訊
如果您在應用程式中使用 Consumer SDK,則必須加入作者資訊文字及 開放原始碼授權納入應用程式的法律聲明部分。建議你 將作者資訊納入獨立選單項目或關於 選單項目。
您可以在「third_party_licenses.txt」中找到授權資訊該檔案位於 已取消封存的 AAR 檔案
如要瞭解如何這麼做,請參閱 https://developers.google.com/android/guides/opensource 包括開放原始碼通知