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 {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.5.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”