Places Aggregate API 是一项服务，可根据位置、类型、营业状态、价格水平和用户评分等条件，提供指定区域内地点的相关数据洞见。此服务可帮助分析给定位置周围特定地点类型的密度，并回答诸如“此位置 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，他们可以收集潜在投资房产附近设施的详细数据，例如 ATM、医院、公交站和杂货店，以便了解潜在投资房产附近的设施。
零售配送服务
在拓展新城市时，零售配送服务需要根据热门消费目的地（例如餐厅、便利店和酒类商店）的密度来确定要为某个区域分配的配送司机数量。借助该 API，配送服务可以统计整个城市中此类商家的总数，以便有效地规划和分配资源。
Places Aggregate API 的运作方式
借助 Places Aggregate API，您可以指定过滤条件来缩小搜索范围。
选择INSIGHT_COUNT或INSIGHT_PLACES的数据洞见类型后，您可以添加过滤条件，包括：
- 地理位置：使用圆形、区域或自定义多边形定义感兴趣的区域。
- 类型：指定您感兴趣的地点类型。
- 营业状态：根据地点的营业状态过滤地点。
- 价格水平：根据价格水平过滤地点。
- 评分：根据用户评分过滤地点。
API 响应 ComputeInsightsResponse 对象包含请求数据分析的结果。例如，如果您选择 INSIGHT_COUNT，则响应会包含地点总数；如果您选择 INSIGHT_PLACES，则响应会包含地点 ID 列表。
如何使用 Places Aggregate API
| 1 | 进行设置。 | 首先设置您的 Google Cloud 项目，然后完成后续说明。 |
| 2 | 发出请求以获取匹配地点的数量。 | 请参阅提交第一个请求。 |
| 3 | 了解请求参数。 | 请参阅请求参数。 |