Trang này được dịch bởi Cloud Translation API.

Định cấu hình dự án trên Google Cloud Console

Cách thiết lập và định cấu hình Google Cloud Console để sử dụng SDK người tiêu dùng Android, hãy làm theo các bước sau.

Thiết lập dự án phát triển.
Thêm SDK người tiêu dùng vào ứng dụng.
Thêm khoá API vào ứng dụng của bạn.
Thêm các thuộc tính bắt buộc vào ứng dụng của bạn.

Để biết thêm thông tin về từng bước, hãy xem các phần sau.

Thiết lập dự án phát triển

Trường hợp bạn không có dự án phát triển trên Google Cloud Console và không có khoá API cho bạn cần thiết lập một dự án về tính di động. Để biết thông tin chi tiết, hãy xem Tạo dự án trong hướng dẫn của Fleet Engine.

Khi bạn chọn dự án phát triển cho SDK người tiêu dùng, hãy chọn cùng một dự án Google Cloud Console và khoá API mà bạn đang dùng cho Fleet Engine.

Thêm SDK người tiêu dùng vào ứng dụng

SDK Người tiêu dùng có sẵn trong một kho lưu trữ Maven riêng tư. Kho lưu trữ bao gồm các tệp Mô hình đối tượng dự án của SDK (.pom) và Javadocs. Để thêm tham số SDK người tiêu dùng cho ứng dụng của bạn, hãy làm theo các bước sau:

Thiết lập môi trường để truy cập vào kho lưu trữ Maven lưu trữ như mô tả trong Bước 2 của hướng dẫn này.
Thêm các phần phụ thuộc SDK người tiêu dùng và SDK Maps vào Gradle hoặc Maven .

Lưu ý: SDK Người tiêu dùng phụ thuộc vào SDK Maps. Đặt phần phụ thuộc thành một phiên bản được xác định rõ ràng của SDK Maps, như được thể hiện trong ví dụ này. Nếu không, SDK Người tiêu dùng sẽ sử dụng phiên bản được yêu cầu tối thiểu của Maps SDK này có thể gây ra vấn đề nếu ứng dụng của bạn dựa vào các tính năng có trong các phiên bản SDK Maps mới hơn.

Trong các ví dụ sau, hãy thay VERSION_NUMBER bằng yêu cầu phiên bản của SDK người tiêu dùng:
Gradle
Thêm phần sau vào 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
Thêm phần sau vào 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>
```

Thêm khoá API vào ứng dụng của bạn

Sau khi thêm SDK người tiêu dùng vào ứng dụng, hãy thêm khoá API. Bạn phải sử dụng khoá API dự án mà bạn nhận được khi thiết lập dự án phát triển. Để để biết thêm chi tiết, hãy xem Thiết lập dự án phát triển trong Bước 3 của hướng dẫn này.

Phần này mô tả cách lưu trữ khoá API để bạn có thể sử dụng khoá một cách an toàn hơn mà ứng dụng của bạn tham chiếu đến. Để biết thêm thông tin về các phương pháp hay nhất để bảo mật khoá API, hãy xem bài viết trên Nền tảng Google Maps về Các phương pháp hay nhất để bảo mật API.

Để đơn giản hoá nhiệm vụ này, bạn có thể sử dụng tài liệu Secrets Gradle (Bí mật) trên GitHub Trình bổ trợ dành cho Android.

Cách cài đặt trình bổ trợ và lưu trữ khoá API:

Mở tệp build.gradle ở cấp cơ sở rồi thêm mã sau vào tệp Phần tử dependencies trong 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")
    }
}

Mở tệp build.gradle ở cấp ứng dụng rồi thêm mã sau vào tệp Phần tử plugins.

Groovy

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

Kotlin

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

Nếu bạn sử dụng Android Studio, hãy đồng bộ hoá dự án với Gradle. Để biết thông tin chi tiết, hãy xem Đồng bộ hoá dự án với Gradle trong tài liệu của Android.
Mở local.properties trong thư mục cấp dự án rồi thêm mã sau. Thay thế YOUR_API_KEY bằng khoá API.

MAPS_API_KEY=YOUR_API_KEY
Trong tệp AndroidManifest.xml, hãy chuyển đến com.google.android.geo.API_KEY rồi cập nhật thuộc tính android:value như sau:

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

Ví dụ sau đây trình bày một tệp kê khai hoàn chỉnh cho một ứng dụng mẫu:

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

Đưa các thuộc tính bắt buộc vào ứng dụng của bạn

Nếu sử dụng SDK người tiêu dùng trong ứng dụng của mình, bạn phải thêm văn bản ghi nhận tác giả và giấy phép nguồn mở trong phần thông báo pháp lý của ứng dụng. Tốt nhất là bạn nên thêm thông tin ghi nhận sự đóng góp dưới dạng một mục trong trình đơn độc lập hoặc trong phần Giới thiệu mục trong trình đơn.

Bạn có thể tìm thấy thông tin giấy phép trong tệp "third_party_permissions.txt" tệp trong tệp AAR đã huỷ lưu trữ.

Hãy tham khảo https://developers.google.com/android/guides/opensource để biết cách bao gồm các thông báo nguồn mở.

Các bước tiếp theo

Nhận mã thông báo xác thực