Maps dành cho Android KTX

Tiện ích Kotlin dành cho Android trên Maps (KTX) là một tập hợp các tiện ích Kotlin cho SDK Maps dành cho Android và SDK Maps dành cho Thư viện tiện ích 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 Kotlin ngắn gọn và đặc trưng khi phát triển SDK Maps dành cho Android. Maps KTX là 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 bản đồ dành cho Android và cho SDK bản đồ cho Thư viện tiện ích Android (không bắt buộc), hãy thêm các phần phụ thuộc sau vào tệp build.gradle.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation 'com.google.maps.android:maps-ktx:5.0.0'
}

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, chẳng hạn như hàm mở rộng, tham số được đặt tên và đối số mặc định, nội dung khai báo giải cấu trúc và coroutine.

Truy xuất GoogleMap bằng coroutine

Bạn có thể truy xuất 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 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")
}

Đang thu thập sự kiện do camera ghi lại

Các sự kiện, chẳng hạn như di chuyển camera, có thể được thu thập thông qua Luồng Kotlin.

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:

  1. Từ GitHub, hãy sao chép hoặc tải tệp ZIP xuống.
  2. Trong Android Studio, hãy chọn File -> Open (Tệp -> Mở) rồi chuyển đến thư mục đó rồi mở thư mục mà bạn vừa sao chép hoặc tải xuống.
  3. Thêm khoá API vào ứng dụng minh hoạ.
    1. Tải SDK Maps dành cho khoá Android.
    2. 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 ở chế độ quản lý phiên bản để bảo vệ khoá API của bạn.
    3. 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ể xem secrets.defaults.properties làm ví dụ.
  4. Trong cấu hình chạy, hãy chọn mô-đun app-ktx.
  5. Chọn Run 'app-ktx'.

Các 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 dành cho Nền tảng Google Maps:

  • KTX cho SDK bản đồ cho Thư viện tiện ích Android
  • KTX cho SDK Địa điểm dành cho Android