ảnh đẹp

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.

Posted on by admin

Sản phẩm hoặc tính năng này đang trong giai đoạn thử nghiệm (giai đoạn trước khi phát hành rộng rãi). Các sản phẩm và tính năng ở giai đoạn trước khi phát hành rộng rãi có thể có phạm vi hỗ trợ hạn chế và các thay đổi đối với sản phẩm và tính năng ở giai đoạn trước khi phát hành rộng rãi có thể không tương thích với các phiên bản ở giai đoạn trước khi phát hành rộng rãi khác. Các sản phẩm ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps. Để biết thêm thông tin, hãy xem phần mô tả giai đoạn phát hành .

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.

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

  1. Tạo một dự án Android Studio mới bằng mẫu Empty Views Activity (Hoạt động xem trống).

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

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

  4. 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” }

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

  1. 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 ý: Đảm bảo bạn 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.

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

  1. Mở tệp app/src/main/AndroidManifest.xml.

  2. 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á từ 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 của Google Cloud, khoá API 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.