概览

请选择平台: Android iOS JavaScript 网络服务

简介

借助 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 AndroidPlaces 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 服务条款用量和结算以及显示提供方说明中所述的要求。