在 Places Aggregate API 中,借助类型过滤条件,您可以选择要在响应中包含或排除哪些类型的地点,从而缩小搜索范围。您可以列出想要和不想要的类型,包括地点的主要类别和其他详细信息。这样一来,您就可以创建特定的搜索内容,准确找到所需地点。
有 200 多种地点类型可供选择。如需查看 Places Aggregate API 支持的完整列表,请参阅 Places API(新)的地点类型下的表 A。
地点类型的运作方式
一个地点可以有多个地点类型:
一个地点可以具有反映其主要功能的单个 主要类型。不过,在某些情况下,可能未指定某个地点的主要类型。
一个地点可以有一个或多个 次要类型。辅助类型是指适用于某个地点的其他类别,用于提供有关该地点的特征和服务方面的补充信息。
例如,某个场所可能会将其主要类型指定为 restaurant
,但由于它还充当酒吧并提供餐饮服务,因此还可以将其次要场所类型指定为 bar, food
和 establishment
。
按类型过滤
如需按主要类型过滤地点,请在请求中使用 includedPrimaryTypes
和 excludedPrimaryTypes
。过滤条件仅适用于地点的主要类型。例如,针对 restaurant
的 includedPrimaryTypes
过滤条件仅返回主要用作餐厅的地点。
如需按主要和次要类型过滤地点,请在请求中使用 includedTypes
和 excludedTypes
。此过滤条件适用于这两种类型。例如,如果 includedTypes
为 bar
,则返回主要类型或次要类型为 bar
的地点。