PLACES_COUNT_PER_TYPE 函数

PLACES_COUNT_PER_TYPE 函数会返回一个表格，其中包含指定给该函数的每个地点类型的计数。例如，如果您搜索类型 doctor、hospital 和 pharmacy，则响应会包含一个表格，其中每种类型都对应一行。

由于 PLACES_COUNT_PER_TYPE 函数会返回一个表，因此请使用 FROM 子句调用该函数。

  • 输入参数：

    • 必需：用于指定搜索区域的 geography filter 参数。geography 参数接受由 BigQuery GEOGRAPHY 数据类型定义的值，该数据类型支持点、线串和多边形。

      如需查看使用不同类型的搜索地理位置（例如视口和线条）的示例，请参阅 PLACES_COUNT 函数。

    • 必需：用于指定要搜索的地点类型的 types 过滤条件参数。

    • 可选：用于缩小搜索范围的其他过滤参数。

  • 返回：

    • 一个表，其中每个 types 值对应一行。该表包含 type (STRING)、count (INT64) 和 place_ids (ARRAY<STRING>) 列，其中 place_ids 包含每个 type 最多 250 个地点 ID。

示例：返回餐厅、咖啡馆和酒吧的数量

在此示例中，您搜索的是纽约市指定搜索区域（以多边形形式定义）内的所有营业中的餐厅、咖啡馆和酒吧。

types 参数接受一个 STRING 值数组，用于指定要搜索的地点类型。如需查看可能值的完整列表，请参阅地点类型。

此示例还使用 BigQuery ST_GEOGFROMTEXT 函数从多边形返回 GEOGRAPHY 值。

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

此函数会返回一个包含三行的表，每种类型对应一行：

纽约市的 Place Count Type 函数的结果。