PLACES_COUNT_PER_TYPE 函数

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

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

  • 输入参数：

    • 必需：geography 过滤条件参数，用于 指定搜索区域。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']
      )
);

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

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