PLACES_COUNT_PER_H3 函数

PLACES_COUNT_PER_H3 函数会接受要搜索的地理区域并返回一个表格，其中包含搜索区域中每个 H3 单元格的地点数量。

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

输入参数：
- 必需：geography 过滤条件参数，用于指定搜索区域。geography 参数的值由 BigQuery GEOGRAPHY 数据类型定义，该类型支持点、线串和多边形。
  
  如需查看使用不同类型的搜索地理位置（例如视口和线条）的示例，请参阅 PLACES_COUNT函数。
- 必需：h3_resolution 过滤条件参数，用于指定用于汇总每个 H3 单元格中的地点数量的H3 分辨率。支持的值介于 0 到 11 之间。
- 可选：其他过滤条件参数，用于优化搜索。
退货：
- 一个表格，其中每行对应一个 H3 单元格。该表格包含列 h3_cell_index (STRING)、geography (GEOGRAPHY)（用于定义表示 H3 单元格的多边形）、count (INT64) 和 place_ids (ARRAY<STRING>)，其中 place_ids 最多包含每个 H3 单元格的 250 个地点 ID。

示例：统计每个 H3 单元格中可供轮椅通行的便利店和杂货店的数量

以下示例计算了纽约市每个 H3 单元格中可供轮椅通行的便利店和杂货店的数量。H3 单元格使用分辨率级别 8。

此示例使用 Overture Maps Data BigQuery 公共数据集获取纽约市的地理位置。

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND subtype = 'locality' AND names.primary = 'New York'  LIMIT 1);

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);