PLACES_COUNT 函数

PLACES_COUNT 函数会根据指定的搜索区域和搜索过滤条件返回地点的单个计数。您必须为 PLACES_COUNT 函数指定搜索区域,还可以选择指定其他过滤参数,例如地点类型、营业状态、价格水平等。

由于 PLACES_COUNT 函数返回单个值,因此请使用 SELECT 子句调用该函数。

  • 输入参数:

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

    • 可选:用于优化搜索的其他过滤条件参数。

  • 返回:

    • 单个 count 值(作为 INT64)。

示例:计算搜索半径内的地点数量

最简单的 PLACES_COUNT 函数调用会返回地理区域中所有地点的单一计数。在此示例中,您将返回帝国大厦 1000 米范围内所有营业场所的数量。

此示例使用 BigQuery ST_GEOGPOINT 函数从点返回 GEOGRAPHY 值。

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000 -- Radius in meters
      )
) as count;

响应包含一个计数:

纽约市地点计数函数的结果。

更典型的调用会向搜索区域应用过滤条件。下一个示例使用过滤条件来限制搜索,以便仅返回以下项的计数:

  • 类型为 restaurant 且最低评分为 3 的地点
  • 提供低价位或中等价位
  • 目前正常运行
  • 允许带狗
SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant"],
      'min_rating', 3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'business_status', ['OPERATIONAL'],
      'allows_dogs', TRUE
      )
) as count;

过滤后的回答:

在纽约市过滤餐馆地点计数函数的结果。

示例:使用多边形计算餐厅数量

您可以使用多边形来指定搜索区域。使用多边形时,多边形的点必须定义一个闭环,其中多边形中的第一个点与最后一个点相同。

此示例使用 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 `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography',geo, -- viewport 
      'types', ["restaurant"],
      'min_rating', 1.0,
      'max_rating', 4.5,
      'min_user_rating_count', 1,
      'max_user_rating_count', 10000,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'business_status', ['OPERATIONAL'],
      'allows_dogs', TRUE
      )
) as count;

视口的响应:

在纽约市视口中过滤餐厅地点计数函数的结果。

示例:计算使用某条线路的餐厅数量

在下一个示例中,您将使用一条连接点线来定义搜索区域,该线周围的搜索半径为 100 米。该线条类似于 Routes API 计算出的出行路线。路线可能适用于车辆、自行车或行人:

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('LINESTRING(-73.98903537033028 40.73655649223003,-73.93580216278471 40.80955538843361)');  -- NYC line

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography',geo, -- line
      'geography_radius', 100, -- Radius around line
      'types', ["restaurant"],
      'min_rating', 1.0,
      'max_rating', 4.5,
      'min_user_rating_count', 1,
      'max_user_rating_count', 10000,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'business_status', ['OPERATIONAL'],
      'allows_dogs', TRUE
      )
) as count;

该行的回答:

在纽约市沿一条线过滤餐馆地点计数函数的结果。

示例:合并多个调用的结果

您可以合并对 PLACES_COUNT 函数的多次调用的结果。例如,您希望通过一个结果显示特定区域内以下价格水平的餐厅数量:

  • PRICE_LEVEL_INEXPENSIVE
  • PRICE_LEVEL_MODERATE
  • PRICE_LEVEL_EXPENSIVE
  • PRICE_LEVEL_VERY_EXPENSIVE"

在此示例中,您将创建一个循环,为每个价格级别调用 PLACES_COUNT 函数,并将每次调用的结果插入到临时表中。然后,您查询临时表以显示结果:

-- Create a temp table to hold the results.
CREATE TEMP TABLE results (type STRING, count INT64);

-- Create a loop that calls PLACES_COUNT for each price level.
FOR types IN (SELECT type FROM UNNEST(["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE", "PRICE_LEVEL_EXPENSIVE", "PRICE_LEVEL_VERY_EXPENSIVE"]) as type)
DO
  INSERT INTO results VALUES (types.type, `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'types', ["restaurant"],
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'price_level', [types.type]
  )));
END FOR;

-- Query the table of results.
SELECT * FROM results;

合并后的回答:

按价格水平过滤餐厅的组合结果。

另一种方法是使用 UNION ALL 命令合并多个 SELECT 语句的结果。以下示例显示了与上一个示例相同的结果:

SELECT "PRICE_LEVEL_INEXPENSIVE" as price_level, `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'types', ["restaurant"],
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'price_level', ['PRICE_LEVEL_INEXPENSIVE']
  )
) as count

UNION ALL

SELECT "PRICE_LEVEL_MODERATE" as price_level, `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'types', ["restaurant"],
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'price_level', ['PRICE_LEVEL_MODERATE']
  )
) as count

UNION ALL

SELECT "PRICE_LEVEL_EXPENSIVE" as price_level, `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'types', ["restaurant"],
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'price_level', ['PRICE_LEVEL_EXPENSIVE']
  )
) as count

UNION ALL

SELECT "PRICE_LEVEL_VERY_EXPENSIVE" as price_level, `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'types', ["restaurant"],
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'price_level', ['PRICE_LEVEL_VERY_EXPENSIVE']
  )
) as count