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

Để thiết lập và định cấu hình dự án trên Google Cloud Console nhằm sử dụng SDK trình điều khiển cho Android, hãy làm theo các bước sau.

  1. Thiết lập dự án ứng dụng dành cho thiết bị di động.
  2. Thêm SDK trình điều khiển vào ứng dụng của bạn.
  3. Thêm khoá API vào ứng dụng của bạn.
  4. 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 ứng dụng di động

Phần này mô tả cách định cấu hình dự án ứng dụng di động cho SDK Trình điều khiển.

Để định cấu hình dự án ứng dụng di động của bạn, hãy làm theo các bước sau:

  1. 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 dự án hỗ trợ di chuyển của mình, bạn cần thiết lập một dự án. Để biết thêm thông tin, hãy xem Tạo dự án Fleet Engine.
  2. Trong Google Cloud Console, hãy chọn chính dự án Google Cloud Console và khoá API mà bạn đang sử dụng cho Fleet Engine.
  3. Chọn API & Services, tìm kiếm và bật SDK Bản đồ dành cho Android.

Thêm SDK trình điều khiển vào ứng dụng

SDK Trình điều khiển có trong kho lưu trữ Google Maven. 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 SDK trình điều khiển vào ứng dụng của bạn, hãy thêm SDK trình điều khiển và SDK điều hướng các phần phụ thuộc vào cấu hình Gradle hoặc Maven của bạn.

Trong ví dụ sau, hãy thay thế VERSION_NUMBER bằng phiên bản đã chọn của SDK Trình điều khiển.

Gradle

Thêm nội dung sau vào 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

Thêm nội dung sau vào 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>

Thêm khoá API vào ứng dụng

Sau khi bạn thêm SDK Trình điều khiển 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 thông tin chi tiết, hãy xem phần Thiết lập dự án ứng dụng di động.

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

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

Để cài đặt trình bổ trợ và lưu trữ khoá API, hãy làm theo các bước sau:

  1. Mở tệp build.gradle cấp gốc và thêm mã sau vào 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")
    }
}

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

    Groovy

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

    Kotlin

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

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

  4. 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 của bạn.

    MAPS_API_KEY=YOUR_API_KEY

  5. 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 cho thấy một tệp kê khai đầy đủ cho một ứng dụng mẫu:

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

Đư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 Trình điều khiển trong ứng dụng, bạn phải đưa văn bản ghi công và các giấy phép nguồn mở vào phần thông báo pháp lý của ứng dụng. Tốt nhất là bạn nên đưa thông tin ghi công vào một mục trình đơn độc lập hoặc một phần của mục trình đơn Giới thiệu.

Bạn có thể tìm thấy thông tin giấy phép trong tệp "third_party_licenses.txt" trong tệp AAR chưa được lưu trữ.

Hãy tham khảo bài viết Bao gồm thông báo nguồn mở để biết cách bao gồm các thông báo nguồn mở.

Các bước tiếp theo

Khai báo phần phụ thuộc