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.2.0")
}

试用示例应用

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

Places KTX 示例应用的第一个屏幕,显示了您的选择
地点搜索演示版应用界面

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

  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”