概览

请选择平台： 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 服务条款、使用和结算以及显示提供方说明中所述的要求。