PLACES_COUNT_PER_TYPE 函数

PLACES_COUNT_PER_TYPE 函数会返回一个表格,其中包含指定给该函数的每个地点类型的计数。例如,如果您搜索类型 doctorhospitalpharmacy,响应将包含一个表格,其中每种类型都对应一行。

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

  • 输入参数:

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

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

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

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

  • 返回:

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

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

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

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

此示例还使用 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 `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

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

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