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.

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:

gcloud projects create "PROJECT"

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"

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

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

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

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.