Thiết lập SDK Bản đồ dành cho Tiện ích Android

Chọn nền tảng: Android iOS

Trang này mô tả cách thiết lập thư viện tiện ích Maps SDK cho Android và chạy ứng dụng minh họa có trong thư viện.

Điều kiện tiên quyết và ghi chú

Thư viện tiện ích Maps SDK cho Android hỗ trợ cấp độ API 15 trở lên của Android. Khi thiết lập đích đến của bản dựng dự án, hãy nhớ sử dụng cấp độ API Android mới nhất.

Tài liệu tham khảo có trên GitHub.

Bước 1. Cài đặt thư viện tiện ích Maps SDK cho Android

Hãy thêm phần phụ thuộc sau đây vào tệp build.gradle.kts của ứng dụng:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.19.0")
}

Sử dụng một trong các tiện ích của thư viện, chẳng hạn như cụm điểm đánh dấu, bản đồ nhiệt hoặc các tiện ích khác.

Bước 2. (Không bắt buộc) Cài đặt thư viện KTX tiện ích Maps SDK cho Android

Thư viện tiện ích Maps SDK cho Android đi kèm với một thư viện tiện ích Kotlin (KTX) tương ứng. Thư viện này cung cấp các tính năng của ngôn ngữ Kotlin (chẳng hạn như hàm mở rộng, đối số được đặt tên và đối số mặc định) để cho phép bạn viết Kotlin ngắn gọn và theo cách thành ngữ. Nếu không phát triển bằng Kotlin, bạn có thể bỏ qua bước này.

Để sử dụng thư viện này, hãy thêm phần phụ thuộc sau vào tệp build.gradle.kts của ứng dụng, ngoài phần phụ thuộc android-maps-utils:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

Hãy xem trang GitHub của Maps KTX để biết thêm thông tin về thư viện này.

Bước 3. Xem mã nguồn thư viện tiện ích Maps SDK dành cho Android

Vì thư viện tiện ích này là mã nguồn mở, nên bạn có thể tải thư viện android-maps-utils xuống máy để tuỳ chỉnh, xem ứng dụng minh hoạ hoặc nếu bạn chỉ muốn tìm hiểu cách thư viện này hoạt động. Bạn có thể thực hiện việc này bằng cách sao chép kho lưu trữ (nên dùng để nhận thông tin cập nhật tự động) hoặc tải tệp zip xuống. Nếu muốn tuỳ chỉnh thư viện, bạn nên phát triển nhánh kho lưu trữ.

Kho lưu trữ bao gồm:

  • Một ứng dụng minh hoạ trong thư mục demo.
  • Thư viện tiện ích trong thư mục library.
  • Nhiều tệp chứa thông tin về giấy phép, người đóng góp và tệp readme.
  • Cấu hình bản dựng Gradle, để sử dụng với Android Studio.

Chạy ứng dụng minh hoạ tiện ích

Kho lưu trữ GitHub cho thư viện tiện ích đi kèm với một ứng dụng minh hoạ có chứa các cách triển khai mẫu của từng tiện ích. Hãy làm theo các bước sau để chạy ứng dụng minh hoạ trên thiết bị Android.

  1. Tải kho lưu trữ xuống bằng một trong các lựa chọn nêu trên.
  2. Trong Android Studio, hãy chọn File -> New -> Import Project (Tệp -> Mới -> Nhập dự án).
  3. Duyệt đến và chọn (nhấp đúp) thư mục android-maps-utils được tạo khi bạn sao chép thư viện tiện ích. Android Studio hiện sẽ tạo dự án.
  4. Nếu bạn đang sử dụng thiết bị Android thay vì trình mô phỏng, hãy nhớ bật chế độ nhà phát triển. Sau đó, hãy kết nối thiết bị Android với máy tính.

  5. Thêm một dòng vào local.properties có dạng như sau:

    MAPS_API_KEY=YOUR_API_KEY

    Trong đó, YOUR_API_KEY là khoá API mà bạn nhận được như mô tả trong phần Sử dụng khoá API.

  6. Tạo và chạy ứng dụng minh hoạ.

Ứng dụng sẽ mở trên thiết bị Android, hiển thị danh sách các tiện ích, bao gồm cả tiện ích phân cụm, polyutil, bản đồ nhiệt và nhiều tiện ích khác. Bạn cũng có thể tìm thấy ứng dụng này trong danh sách ứng dụng, bên dưới tên Maps Utils Demo.