详细了解类型过滤条件

在 Places Aggregate API 中，借助类型过滤条件，您可以选择要在响应中包含或排除哪些类型的地点，从而缩小搜索范围。您可以列出想要和不想要的类型，包括地点的主要类别和其他详细信息。这样一来，您就可以创建特定的搜索内容，准确找到所需地点。

有 200 多种地点类型可供选择。如需查看 Places Aggregate API 支持的完整列表，请参阅 Places API（新）的地点类型下的表 A。

地点类型的运作方式

一个地点可以有多个地点类型：

• 一个地点可以具有反映其主要功能的单个 主要类型。不过，在某些情况下，可能未指定某个地点的主要类型。

• 一个地点可以有一个或多个 次要类型。辅助类型是指适用于某个地点的其他类别，用于提供有关该地点的特征和服务方面的补充信息。

例如，某个场所可能会将其主要类型指定为 restaurant，但由于它还充当酒吧并提供餐饮服务，因此还可以将其次要场所类型指定为 bar, food 和 establishment。

按类型过滤

如需按主要类型过滤地点，请在请求中使用 includedPrimaryTypes 和 excludedPrimaryTypes。过滤条件仅适用于地点的主要类型。例如，针对 restaurant 的 includedPrimaryTypes 过滤条件仅返回主要用作餐厅的地点。

如需按主要和次要类型过滤地点，请在请求中使用 includedTypes 和 excludedTypes。此过滤条件适用于这两种类型。例如，如果 includedTypes 为 bar，则返回主要类型或次要类型为 bar 的地点。

重要提示：使用多个过滤条件时，请务必了解过滤条件之间的互动方式。具体而言，同一过滤条件中的地点是使用 OR 逻辑进行评估的，而不同过滤条件中的地点是使用 AND 逻辑进行评估的。

• 在过滤条件内（OR 逻辑）：例如，includedTypes: restaurant, bar 表示该地点可以是 restaurant，也可以是 bar。
• 跨过滤条件（AND 逻辑）：所有指定的过滤条件都必须同时满足。这意味着每个过滤条件都会为查询添加一层限制，只有满足所有条件的地点才会包含在结果中。

例如，如果您设置了 includedTypes: restaurant, bar 和 excludedTypes: hotel，则 includedTypes 过滤条件会先选择所有归类为 restaurant 或 bar 的地点。其次，excludedTypes 过滤条件会从所选内容中移除所有也归类为 hotel 的地点。因此，查询将返回属于 restaurant 或 bar 的地点，但前提是这些地点在任何类型（主要类型或次要类型）中均未被归类为 hotel。