简介
借助 Places SDK for Android,您可以构建具备位置感知能力的应用,以便根据上下文对用户设备附近的本地商家和其他地点做出响应。也就是说,您可以根据对用户有意义的地点构建丰富的应用,以补充 Android 位置信息服务提供的简单地理位置服务。
概念
以下接口提供了 Places SDK for Android 的主要入口点:
Places
可通过编程方式访问包含本地地点和商家信息的 Google 数据库,以及设备的当前地点。Autocomplete
提供预先创建的 widget,以便针对用户搜索查询返回地点预测结果。
地点是指具有名称的实际空间。您还可以将地点视为您在地图上可以找到的任何内容。
例如本地商家、地图注点和地理位置。在该 API 中,地点由 Place
接口表示。其中包括地点的名称及其地址、地理位置、地点 ID、电话号码、地点类型、网站网址等信息。
选择您的 SDK 版本
应用中可用的 Places SDK for Android 功能取决于您在应用配置中指定的 SDK 版本号(例如 3.5.0)、在 API 密钥上启用的 API 以及应用的初始化方式。如需详细了解 Places SDK for Android 和 Places SDK for Android(新版)之间的区别,请参阅选择 SDK 版本。
首先,您需要确定要使用的 SDK。无论您是新客户还是已经在使用该 SDK 的现有客户,都适用。如需了解这两个 SDK 版本之间的主要区别,请参阅选择 SDK 版本。
每个 SDK 版本的价格
您启用的 SDK 版本决定了您使用该 SDK 的价格。 Places SDK for Android(新版)支持简化的定价模式,因此您只需支付所用数据的费用。如需详细了解 Places SDK for Android 和 Places SDK for Android(新版)的定价信息,请参阅使用和结算。
API 概览
帮助客户探索自己所在的位置以及周围环境:
- 地点自动补全功能会在用户输入内容时自动填充地点的名称和/或地址。
- 当前地点会返回用户设备最近一次的已知位置的列表,以及每个地点的相对概率。
- 地点详情会返回和显示有关地点的更多详细信息。
- 文本搜索会根据搜索文本字符串返回地点。文本搜索是 Places SDK for Android(新版)的一部分。
- 地点照片会返回地点的高品质图片。
- 地点 ID 用于存储一个或多个地点的唯一 ID,以便按需检索地点信息。
政策和条款
使用 Places SDK for Android 的所有应用都必须遵守 Google Maps Platform 服务条款、使用和结算以及显示提供方说明中所述的要求。