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