概览

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

简介

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