概览

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

准备工作： 在开始使用 Places SDK for Android 之前，请确保您的项目已关联结算账号并且启用了 Places API 。我们建议创建多个 Project Owner 和 Billing Administrator，确保您的团队中始终有担任这些角色的成员。如需了解详情，请参阅在 Cloud 控制台中进行设置。

简介

借助 Places SDK for Android，您可以构建具备位置感知能力的应用，以便根据上下文对用户设备附近的本地商家和其他地点做出响应。也就是说，您可以根据对用户有意义的地点构建丰富的应用，以补充 Android 位置信息服务提供的简单地理位置服务。

注意：Places SDK（新版）是 Places SDK for Android 的当前版本。 Places SDK 现已成为旧版，无法再启用。旧版标签页上提供了旧版文档和迁移指南。

概念

以下接口提供了 Places SDK for Android 的主要入口点：

• Places 可通过编程方式访问 Google 的本地地点和商家信息数据库，以及设备的当前地点。
• Autocomplete 提供预先创建的 widget，以便针对用户搜索查询返回地点预测结果。

地点是指具有名称的实际空间。您还可以将地点视为您在地图上可以找到的任何内容。 例如本地商家、地图注点和地理位置。在该 API 中，地点由 Place 接口表示。其中包括地点的名称及其地址、地理位置、地点 ID、电话号码、地点类型、网站网址等信息。

注意：每当您的应用显示来自 Places SDK for Android 的地点相关信息时，还必须显示该 API 返回的所有相关提供方说明。 请参阅有关显示提供方信息的文档。

API 概览

帮助客户探索自己所在的位置以及周围环境：

• 地点自动补全功能会在用户输入内容时自动填充地点的名称和/或地址。
• 地点详情会返回和显示有关地点的更多详细信息。
• 附近搜索会根据位置和搜索半径返回地点列表。
• 地点照片会返回地点的高品质图片。
• 文本搜索会根据搜索文本字符串返回地点。
• 地点 ID 用于存储一个或多个地点的唯一 ID，以便按需检索地点信息。

注意：Google 会收集匿名使用情况统计信息。

政策和条款

使用 Places SDK for Android 的所有应用都必须遵守 Google Maps Platform 服务条款、使用和结算以及显示提供方说明中所述的要求。