Trang này mô tả cách thiết lập SDK Bản đồ dành cho Android thư viện tiện ích và để chạy ứng dụng minh hoạ có trong thư viện.
Điều kiện tiên quyết và lưu ý
Thư viện tiện ích Maps SDK dành cho Android hỗ trợ Android API level 15 trở lên. Khi đặt mục tiêu xây dựng dự án, hãy đảm bảo bạn sử dụng phiên bản mới nhất Cấp độ API của Android.
Chiến lược phát hành đĩa đơn tham chiếu có trên GitHub.
Bước 1. Cài đặt SDK Maps dành cho thư viện tiện ích Android
Hãy thêm phần phụ thuộc sau đây vào tệp build.gradle
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.8.0' }
Sử dụng một trong các tiện ích từ thư viện, chẳng hạn như điểm đánh dấu phân cụm, bản đồ nhiệt hoặc phần kia tiện ích.
Bước 2. (Không bắt buộc) Cài đặt SDK bản đồ cho thư viện tiện ích Android KTX
Thư viện tiện ích Android SDK bản đồ đi kèm với một tiện ích Kotlin tương ứng (KTX). Thư viện này cung cấp các tính năng cho ngôn ngữ Kotlin, chẳng hạn như các hàm mở rộng, được đặt tên là và đối số mặc định – để cho phép bạn viết Kotlin ngắn gọn và đặc trưng. Nếu bạn không đang 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, ngoài phần phụ thuộc
Phần phụ thuộc android-maps-utils
vào tệp build.gradle
của ứng dụng:
dependencies { // KTX for the Maps SDK for Android Utility Library implementation 'com.google.maps.android:maps-utils-ktx:5.1.1' }
Xem trang Maps KTX GitHub để biết thêm thông tin về thư viện này.
Bước 3. Xem SDK Maps dành cho mã nguồn thư viện tiện ích Android
Vì thư viện tiện ích là nguồn mở, bạn có thể tải xuống android-maps-utils vào máy của bạn để tuỳ chỉnh, xem ứng dụng minh hoạ hoặc nếu bạn chỉ muốn biết cách thư viện 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 các bản cập nhật tự động) hoặc đang tải xuống tệp zip. Nếu muốn tuỳ chỉnh thư viện, bạn nên phát triển repo.
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
. - Các tệp khác nhau chứa thông tin về giấy phép, người đóng góp và 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 một ứng dụng minh hoạ bao gồm mẫu cách triển khai từng phần mềm tiện ích. Làm theo các bước sau để chạy ứng dụng minh hoạ trên thiết bị Android của bạn.
- Tải kho lưu trữ xuống bằng một trong các cách nêu trên.
- Trong Android Studio, chọn File -> (Tệp ->) Mới -> Nhập dự án.
- Duyệt qua và chọn (nhấp đúp) vào Thư mục android-maps-utils được tạo khi bạn đã sao chép thư viện tiện ích. Android Studio giờ đây sẽ tạo dự án.
- 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 đó, kết nối thiết bị Android với máy tính.
Thêm một dòng đơn vào
local.properties
như sau:MAPS_API_KEY=YOUR_API_KEY
Trong đó YOUR_API_KEY là khoá API bạn nhận được như mô tả trong Sử dụng khoá API.
- Tạo và chạy ứng dụng minh hoạ.
Ứng dụng sẽ mở trên thiết bị Android, hiển thị một danh sách tiện ích bao gồm cả tính năng phân cụm, poyutil, bản đồ nhiệt và nhiều tính năng khác. Bạn cũng có thể tìm thấy ứng dụng này trong danh sách ứng dụng của bạn, dưới tên Bản minh hoạ tiện ích bản đồ.