Places Aggregate API 是一项服务，可根据位置、类型、营业状态、价格水平和用户评分等条件，提供指定区域内地点的数据分析洞见。这项服务有助于分析给定位置周围特定 地点类型的密度，并回答“此位置 5 公里半径范围内有多少家 5 星级 $$$ 餐厅？”之类的问题。
结果以汇总计数或感兴趣的搜索区域中已识别的地点 ID 的形式返回。用户可以使用 地点详情 API 来检索有关这些地点 ID 的更多信息。
为何使用 Places Aggregate API
Places Aggregate API 可让用户根据您提供的有关各种地点的全面信息，做出数据驱动型决策。它利用准确且最新的地点模型，支持以下主要用例：
- 企业：分析竞争情况，并为新 分店寻找潜在地点。
- 开发者：构建提供个性化 推荐的应用。
- 研究人员：检查特定区域的趋势和模式。
您可以使用 Places Aggregate API 执行的操作
借助 Places Aggregate API，您可以获取以下信息：
- 计数：检索符合条件的地点数量。
- 地点 ID：检索符合 条件的特定地点的地点 ID。
您还可以使用过滤条件 ，根据地点类型、营业时间、价格水平和客户评分等各种属性来优化搜索。
示例
本部分介绍了 Places Aggregate API 的示例用例，并为每个示例提供了可运行的代码。
开设新咖啡馆
一家餐厅的老板想开设一家新咖啡馆。为此，他们首先想直观了解咖啡馆的热点区域，以便确定咖啡馆集中度高的区域和集中度低的区域，从而为业务决策提供依据。Places Aggregate API 可以根据运营状态、价格水平和客户评分等属性，帮助分析特定半径范围内的咖啡馆数量，以便根据数据做出关于下一个地点开设在哪里的决策。
房地产投资公司
一家房地产投资公司想要增强其财务模型，并准确确定其计划投资的房产的投资回报率。通过使用 Places Aggregate API，他们可以收集有关潜在投资房产附近便利设施（例如自动取款机、医院、公交车站和杂货店）的详细数据，以便了解潜在投资房产附近的便利设施。
零售配送服务
在扩展到新城市时，零售配送服务需要根据热门消费目的地（例如餐厅、便利店和酒类商店）的密度，确定要分配给某个区域的配送员数量。借助该 API，配送服务可以统计整个城市中此类场所的总数，以便有效地规划和分配资源。
Places Aggregate API 的运作方式
Places Aggregate API 可让您指定过滤条件来缩小搜索条件范围。
选择 INSIGHT_COUNT 或
INSIGHT_PLACES 的 Insight Type 后，您可以添加过滤条件，包括以下内容：
- 位置：使用圆形、区域或自定义 多边形定义感兴趣的区域。
- 类型：指定您感兴趣的地点类型。
- 运营状态：根据地点的运营状态过滤地点。
- 价格水平：根据价格水平过滤地点。
- 评分：根据用户评分过滤地点。
API 响应 ComputeInsightsResponse 对象包含请求分析洞见的结果。例如，如果您选择了
INSIGHT_COUNT，则响应包含地点总数；如果您选择了 INSIGHT_PLACES，则响应包含地点 ID 列表。
如何使用 Places Aggregate API
| 1 | 进行设置。 | 首先按照设置您的 Google Cloud 项目 中的说明进行操作，然后完成后续说明。 |
| 2 | 发出请求以获取匹配地点的数量。 | 请参阅提交第一个请求。 |
| 3 | 了解请求参数。 | 请参阅请求参数。 |