Places Android KTX 概览和设置

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

安装适用于 Places SDK 的 KTX

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

dependencies {

    // KTX for the Places SDK for Android library
    implementation 'com.google.maps.android:places-ktx:3.1.1'
}

试用示例应用

该库的 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. 选择 Run 'app-places-ktx'