Places Android KTX 概览和设置

Places Android KTX 是一系列 Kotlin 扩展程序的集合，适用于 Places SDK for Android。这些扩展程序提供多种 Kotlin 语言功能，可让您在针对 Places SDK for Android 进行开发时编写简洁而惯用的 Kotlin 代码。Places KTX 是开源的，您可以在 GitHub 上获取 Places KTX 及相关示例。

为 Places SDK 安装 KTX

如需为 Places SDK for Android 安装 KTX，请将以下依赖项添加到应用级 build.gradle.kts 文件中。

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

试用示例应用

该库的 GitHub 代码库还包含一个演示版应用，用于展示如何在您自己的应用中使用 Places KTX 库。

Places KTX 示例应用的第一个界面，显示您的选择
Places Search 演示版应用界面

如需试用演示版应用，请按照以下步骤操作：

  1. 从 GitHub 克隆或下载 ZIP 文件。
  2. 在 Android Studio 中，依次选择文件 -> 打开，前往您刚刚克隆或下载文件的文件夹并将其打开。
  3. 向演示版应用添加 API 密钥。
    1. 获取 Places API 密钥。
    2. 在根目录中，创建一个名为 secrets.properties 的文件。为保护您的 API 密钥，不应对此文件进行版本控制。
    3. 将以下单行代码添加到 secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
       其中 YOUR_API_KEY 是您在第一步中获得的实际 API 密钥。您可以以 local.defaults.properties 为例。
  4. 在运行配置下，选择模块 app-places-ktx。
  5. 选择运行“app-places-ktx”。