Địa điểm Tổng quan và thiết lập KTX của Android

Places Android KTX là một tập hợp các tiện ích Kotlin cho Places SDK for 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à tự nhiên khi phát triển cho Places SDK for Android. Places KTX là nguồn mở và có trên GitHub cùng với các ví dụ.

Cài đặt KTX cho Places SDK

Để cài đặt KTX cho Places SDK for Android, hãy thêm các phần phụ thuộc sau vào tệp build.gradle.kts cấp ứng dụng.

dependencies {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.3.1")
}

Dùng 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 Places KTX trong ứng dụng của riêng mình.

Màn hình đầu tiên của ứng dụng mẫu Places KTX, cho thấy các lựa chọn của bạn
Màn hình ứng dụng minh hoạ tính năng Tìm kiếm địa điểm

Để dùng thử ứng dụng minh hoạ, hãy làm theo các bước sau:

  1. Trên GitHub, hãy sao chép hoặc tải tệp ZIP xuống.
  2. Trong Android Studio, hãy chọn File (Tệp) -> Open (Mở) rồi chuyển đến thư mục và 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. Lấy khoá Places API.
    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 nằm trong chế độ kiểm soát phiên bản để bảo vệ khoá API của bạn.
    3. Thêm dòng đơn này vào secrets.properties
      PLACES_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 local.defaults.properties làm ví dụ.
  4. Trong cấu hình chạy, hãy chọn mô-đun app-places-ktx.
  5. Chọn Run 'app-places-ktx'. (Chạy 'app-places-ktx').