Tiện ích Kotlin cho Maps Android (KTX) là một tập hợp các tiện ích Kotlin cho SDK Maps dành cho Android và Thư viện tiện ích SDK Maps dành cho Android. Các tiện ích này cung cấp các tính năng ngôn ngữ Kotlin cho phép bạn viết mã Kotlin ngắn gọn và phù hợp khi phát triển cho SDK Maps dành cho Android. Maps KTX là mã nguồn mở và có sẵn trên GitHub cùng với các ví dụ.
Cài đặt
Để cài đặt KTX cho SDK Maps cho Android và tuỳ ý cho SDK Maps cho Thư viện tiện ích Android, hãy thêm các phần phụ thuộc sau vào tệp build.gradle.kts
.
dependencies { // KTX for the Maps SDK for Android library implementation("com.google.maps.android:maps-ktx:5.1.1") }
Ví dụ về cách sử dụng
Với thư viện KTX, bạn có thể tận dụng một số tính năng của ngôn ngữ Kotlin như hàm mở rộng, tham số được đặt tên và đối số mặc định, khai báo trích xuất và coroutine.
Truy xuất GoogleMap bằng coroutine
Bạn có thể truy cập GoogleMap
bằng cách sử dụng coroutine.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { val mapFragment: SupportMapFragment? = supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment val googleMap: GoogleMap? = mapFragment?.awaitMap() } }
Thêm điểm đánh dấu
Bạn có thể thêm điểm đánh dấu bằng cách sử dụng phương thức kiểu DSL addMarker()
.
val sydney = LatLng(-33.852, 151.211) val marker = googleMap.addMarker { position(sydney) title("Marker in Sydney") }
Thu thập sự kiện máy ảnh
Bạn có thể thu thập các sự kiện, chẳng hạn như chuyển động của máy ảnh, thông qua Kotlin Flow.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { googleMap.cameraMoveEvents().collect { print("Received camera move event") } } }
Bạn có thể xem danh sách đầy đủ các tính năng được hỗ trợ bằng cách đọc tài liệu tham khảo.
Thử ứng dụng mẫu
Kho lưu trữ GitHub cho thư viện này cũng chứa một ứng dụng minh hoạ cho biết cách bạn có thể sử dụng thư viện Maps KTX trong ứng dụng của riêng mình.
Để dùng thử ứng dụng minh hoạ, hãy làm theo các bước sau:
- Trên GitHub, hãy sao chép hoặc tải tệp ZIP xuống.
- Trong Android Studio, hãy chọn File -> Open (Tệp -> Mở), sau đó chuyển đến thư mục và mở thư mục mà bạn vừa nhân bản hoặc tải xuống.
- Thêm khoá API vào ứng dụng minh hoạ.
- Lấy khoá SDK Bản đồ dành cho Android.
- Trong thư mục gốc, hãy tạo một tệp có tên là
secrets.properties
. Tệp này KHÔNG được nằm trong chế độ kiểm soát phiên bản để bảo vệ khoá API của bạn. - Thêm dòng này vào
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
trong đóYOUR_API_KEY
là khoá API thực tế mà bạn đã nhận được ở bước đầu tiên. Bạn có thể xemsecrets.defaults.properties
làm ví dụ. - Trong cấu hình chạy, hãy chọn mô-đun app-ktx.
- Chọn Run 'app-ktx' (Chạy 'app-ktx').
Bước tiếp theo
Bạn cũng có thể quan tâm đến các thư viện tiện ích Kotlin khác cho Nền tảng Google Maps: