Thiết lập

Trang này mô tả những việc bạn cần làm để thiết lập và bắt đầu tạo bằng SDK Maps 3D dành cho Android. Quy trình thiết lập bao gồm việc định cấu hình một dự án và API trên Google Cloud để sử dụng với SDK, sau đó thiết lập một dự án Android Studio. Hãy hoàn tất các bước này trước khi thêm bản đồ 3D đầu tiên vào ứng dụng của bạn.

Thiết lập dự án trên đám mây và khoá API trên Google Cloud

Trước khi có thể bắt đầu tạo bằng SDK Maps 3D dành cho Android, bạn cần thiết lập một dự án trên đám mây và khoá API trên Google Cloud để sử dụng với SDK Maps 3D dành cho Android bằng cách hoàn tất các bước sau:

Bước 1

Giao diện dòng lệnh

Trong bảng điều khiển Cloud, trên trang chọn dự án, hãy nhấp vào Create Project (Tạo dự án) để bắt đầu tạo một dự án mới trên Cloud project.

Chuyển đến trang chọn dự án
Đảm bảo rằng bạn đã bật tính năng thanh toán cho dự án trên Cloud. Xác nhận rằng bạn đã bật tính năng thanh toán cho dự án.

Google Cloud cung cấp bản dùng thử miễn phí. Bản dùng thử sẽ hết hạn vào cuối 90 ngày hoặc sau khi tài khoản tích luỹ được 300 USD phí, tuỳ vào điều kiện nào đến trước. Bạn có thể huỷ bất cứ lúc nào. Để biết thêm thông tin, hãy xem Khoản tín dụng trong tài khoản thanh toán và Thanh toán.

SDK đám mây

gcloud projects create "PROJECT"

Đọc thêm về Google Cloud SDK , cách cài đặt Cloud SDK và các lệnh sau:

gcloud projects create

Bước 2

Để sử dụng Google Maps Platform, bạn phải bật các API hoặc SDK mà bạn định sử dụng với dự án của mình.

Xin lưu ý rằng một số quy trình tích hợp yêu cầu bạn bật nhiều API/SDK. Nếu bạn không chắc nên bật API hoặc SDK nào, hãy thử sử dụng Trình khám phá tính năng hoặc tham khảo tài liệu về API/SDK mà bạn muốn sử dụng.

Cách bật một hoặc nhiều API hoặc SDK:

Giao diện dòng lệnh

Xem các API và SDK của Google Maps Platform mà bạn có thể bật bằng cách chuyển đến trang Thư viện API Maps trong bảng điều khiển Cloud:

Chuyển đến trang Thư viện API Maps
Nhấp vào API hoặc SDK mà bạn muốn bật.
- Nếu nút này có nội dung là ENABLE (BẬT), hãy nhấp vào nút đó để bật API hoặc SDK.
- Nếu nút này có nội dung là MANAGE (QUẢN LÝ), thì API hoặc SDK đã được bật và bạn không cần làm gì thêm.
- Khi bạn nhấp vào nút này, trang tổng quan cho API hoặc SDK sẽ xuất hiện. (Nhấp vào nút DISABLE để xoá API hoặc SDK khỏi dự án này.)

SDK đám mây

Lệnh sau sẽ bật tất cả API Maps, Tuyến đường và Địa điểm:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Đọc thêm về Google Cloud SDK , cách cài đặt Cloud SDK và các lệnh sau:

Sử dụng lệnh này để bật API Môi trường:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Bước 3

Bước này chỉ hướng dẫn quy trình tạo Khoá API. Nếu bạn sử dụng Khoá API trong quá trình phát hành chính thức, bạn nên hạn chế khoá API. Bạn có thể tìm thêm thông tin trên trang Using API Keys (Sử dụng khoá API) dành riêng cho sản phẩm.

Khoá API là một mã nhận dạng duy nhất giúp xác thực các yêu cầu liên kết với dự án của bạn cho mục đích sử dụng và thanh toán. Bạn phải có ít nhất một khoá API liên kết với dự án của mình.

Cách tạo khoá API:

Giao diện dòng lệnh

Chuyển đến trang Google Maps Platform > Credentials (Nền tảng Google Maps > Thông tin đăng nhập).

Chuyển đến trang Thông tin đăng nhập
Trên trang Credentials (Thông tin đăng nhập), hãy nhấp vào Create credentials > API key (Tạo thông tin đăng nhập > Khoá API).
Hộp thoại API key created (Đã tạo khoá API) sẽ hiển thị khoá API mới tạo.
Nhấp vào Close (Đóng).
Khoá API mới sẽ xuất hiện trên trang Credentials (Thông tin đăng nhập) trong phần API keys (Khoá API).
(Hãy nhớ hạn chế khoá API trước khi sử dụng trong quá trình phát hành chính thức.)

SDK đám mây

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Đọc thêm về Google Cloud SDK , cách cài đặt Cloud SDK và các lệnh sau:

gcloud services api-keys create

Để bật SDK, hãy xem trang SDK Maps 3D dành cho Android trong bảng điều khiển Cloud của Google. Để biết thêm thông tin về cách hoàn tất các bước này, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.

Thiết lập dự án Android Studio

Phần này giải thích cách tạo và định cấu hình một dự án Android Studio để sử dụng với SDK Maps 3D dành cho Android.

Phần 1: Thiết lập dự án và cấu hình Gradle

Tạo một dự án Android Studio mới bằng mẫu Empty Views Activity (Hoạt động xem trống).
Nếu bạn đang sử dụng Git để kiểm soát nguồn, hãy sửa đổi tệp .gitignore của dự án để ngăn tệp khoá bí mật của bạn được cam kết quản lý phiên bản:
- Trong thư mục gốc của dự án, hãy mở tệp .gitignore.
- Hãy thêm dòng lệnh sau đây:
```
secrets.properties
```

Cập nhật tệp build.gradle.kts ở cấp dự án:

Trong thư mục gốc của dự án, hãy mở tệp build.gradle.kts.
Trong khối plugins, hãy thêm trình bổ trợ Secrets Gradle:

plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

Cập nhật tệp gradle/libs.versions.toml:

Mở tệp gradle/libs.versions.toml. Tệp này thường nằm trong thư mục gradle trong thư mục gốc của dự án.
Trong phần [versions], hãy thêm các phiên bản cho SDK và trình bổ trợ Secrets Gradle:

# See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
maps3dSdk = "0.2.0"
# See https://github.com/google/secrets-gradle-plugin/releases for available releases
secretsGradlePlugin = "2.0.1"

Trong phần [library], hãy thêm thư viện SDK:

play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

Trong phần [plugins], hãy thêm trình bổ trợ Secrets Gradle:

secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

Cập nhật tệp app/build.gradle.kts ở cấp mô-đun:

Mở tệp build.gradle.kts ở cấp mô-đun. Tệp này thường nằm trong thư mục app.
Ở đầu tệp, hãy thêm trình bổ trợ Secrets Gradle vào khối plugins:

plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.kotlin.android)
    alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

Trong khối dependencies, hãy thêm SDK:

dependencies {
    // ... other dependencies
    implementation(libs.play.services.maps3d) // Add this line
}

Ở cuối tệp, bên ngoài các khối android và dependencies, hãy thêm cấu hình bí mật:

secrets {
    // Optionally specify a different filename containing your secrets.
    // The plugin defaults to "local.properties"
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

Phần 2: Thêm khoá API vào dự án

Tạo tệp secrets.properties:
- Trong thư mục gốc của mô-đun ứng dụng (thường là thư mục app), hãy tạo một tệp mới có tên là secrets.properties.
- Thêm khoá API vào tệp:
```
MAPS3D_API_KEY=YOUR_API_KEY_HERE
```
Lưu ý: Hãy nhớ thay thế YOUR_API_KEY_HERE bằng khoá API mà bạn đã định cấu hình để sử dụng với SDK Maps 3D dành cho Android.
Tạo tệp local.defaults.properties: - Trong thư mục gốc của mô-đun ứng dụng, hãy tạo một tệp mới có tên là secrets.properties. - Thêm khoá API mặc định hoặc khoá API giữ chỗ vào tệp. Bạn có thể kiểm tra tệp này trong phần quản lý phiên bản:
```
MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
```

Phần 3: Cập nhật tệp `AndroidManifest.xml`

Mở tệp app/src/main/AndroidManifest.xml.
Bên trong thẻ <application>, trước thẻ <activity>, hãy thêm phần tử <meta-data> sau để khai báo khoá API:
```
<application
    ...>

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

    <activity
        ...>
    </activity>
</application>
```
Trong quy trình xây dựng, Trình bổ trợ Secrets Gradle sẽ thay thế phần giữ chỗ ${MAPS3D_API_KEY} bằng khoá trong tệp secrets.properties.

Các bước tiếp theo

Giờ đây, bạn đã thiết lập một dự án trên đám mây, khoá API trên Google Cloud và một dự án Android Studio để sử dụng với SDK Maps 3D dành cho Android, bạn có thể Thêm bản đồ 3D vào ứng dụng của mình.

Thiết lập Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Thiết lập dự án trên đám mây và khoá API trên Google Cloud

Bước 1

Giao diện dòng lệnh

SDK đám mây

Bước 2

Giao diện dòng lệnh

SDK đám mây

Bước 3

Giao diện dòng lệnh

SDK đám mây

Thiết lập dự án Android Studio

Phần 1: Thiết lập dự án và cấu hình Gradle

Phần 2: Thêm khoá API vào dự án

Phần 3: Cập nhật tệp AndroidManifest.xml

Các bước tiếp theo

Thiết lập

Phần 3: Cập nhật tệp `AndroidManifest.xml`