关于 Places Insights 数据和查询

地点数据分析数据

地点数据分析 在 BigQuery 中提供完整数据集和示例数据集。

示例数据集旨在让您试用地点数据分析,以便您在决定购买完整数据集之前评估该产品的易用性和价值。示例数据集仅包含城市本身的数据。不包含周边大都市区的数据。

示例列表包含每个受支持国家/地区的热门城市的数据:

  • 阿姆斯特丹(荷兰)
  • 安卡拉 (TR)
  • 阿雷基帕 (PE)
  • 雅典 (GR)
  • 巴特加施泰因 (AT)
  • 柏林(德国)
  • 布尔诺 (CZ)
  • 布鲁塞尔 (BE)
  • 布加勒斯特 (RO)
  • 布宜诺斯艾利斯 (AR)
  • 釜山 (KR)
  • 开罗 (EG)
  • 清迈(泰国)
  • 哥本哈根 (DK)
  • 科克 (IE)
  • 德布勒森(匈牙利)
  • 河内 (VN)
  • 赫尔辛基 (FI)
  • 香港 (HK)
  • 雅加达 (ID)
  • 吉达(沙特阿拉伯)
  • 约翰内斯堡 (ZA)
  • 吉隆坡 (MY)
  • 里斯本 (PT)
  • 伦敦(英国)
  • 卢塞尔(卡塔尔)
  • 马德里(西班牙)
  • 马尼拉 (PH)
  • 麦德林 (CO)
  • 墨西哥城 (MX)
  • 孟买 (IN)
  • 纽约市(美国)
  • 奥斯陆 (NO)
  • 巴黎(法国)
  • 普罗夫迪夫 (BG)
  • 里法 (BH)
  • 罗马 (IT)
  • 圣地亚哥 (CL)
  • 圣保罗 (BR)
  • 沙迦 (AE)
  • 新加坡 (SG)
  • 斯德哥尔摩 (SE)
  • 悉尼(澳大利亚)
  • 台北 (TW)
  • 特拉维夫-雅法(以色列)
  • 东京(日本)
  • 多伦多(加拿大)
  • 华沙 (PL)
  • 惠灵顿(新西兰)
  • 苏黎世 (CH)

完整数据集包含每个受支持国家/地区的数据,必须购买。如果您有兴趣注册使用地点数据分析,请填写申请表单。 只有数据订阅者需要请求对地点数据分析数据集的访问权限。在 BigQuery 项目中启用订阅后,任何有权访问该项目的用户都可以查询地点数据分析数据。

每个国家/地区的数据集都有自己的列表,您必须单独订阅。 如需详细了解如何订阅商品详情,请参阅设置地点数据分析。

数据集架构

每个国家/地区的地点数据集架构由两部分组成:

例如,如果您使用的是西班牙 (ES) 的数据集,请同时参考核心架构和 ES 专用架构。

brands 数据集的架构定义了三个字段:

  • id:品牌 ID。
  • name:品牌名称,例如“Hertz”或“Chase”。
  • category:品牌的高级类别,例如“加油站”“餐饮”或“住宿”。

查询地点数据分析数据

地点数据分析提供两种查询数据集的方式:

  • 直接使用 SQL 查询数据集:对数据集表执行标准 BigQuery SQL 查询。这为复杂过滤、与您自己的数据联接、自定义分析以及支持 COUNT 以外的其他聚合函数(例如 AVG、SUM 和 GROUP BY)提供了最大的灵活性。请参阅文档。
  • 使用地点计数函数查询数据集:地点计数函数是预定义的优化 SQL 查询,可直接在 BigQuery 中运行,并简化常见的数据检索任务。它们可提供更精细的数据洞见,例如返回地点 ID 以查找有关各个地点的详细信息。请参阅文档。

直接查询

直接查询数据会强制执行汇总阈值 1。仅当结果行汇总了至少 1 个地点时,系统才会返回该结果行。如果您的搜索条件与 0 个地点匹配,则系统会从响应中省略该行。

地点计数函数查询

地点计数函数可以返回地点 ID 列表,这些 ID 可用于通过其他 GMP 产品(例如 Places API 和 Places UI Kit)查找各个地点的信息。

地点计数功能不会强制执行汇总阈值,而是强制执行 40.0 米 x 40.0 米(1600 平方米)的最小搜索区域。这意味着,只要您的搜索查询大于最小搜索区域,您就始终会获得结果,即使有 0 个地点与您的查询匹配也是如此。

何时直接查询数据,何时使用函数

如果您想获得计数以外的数据洞见(例如 AVG、SUM 或 COUNTIF),或者需要执行更复杂的查询(例如联接数据集),请直接查询数据。

如果您需要返回地点 ID 以查找个别地点信息(例如地点名称或地址),或者希望查询明确返回 0 计数而不是省略它们,请使用这些函数进行查询。

下表详细比较了直接查询和地点计数函数之间的差异。

地点计数函数 直接数据集查询
优势
  • 返回可用于查询其他 API 的地点 ID。
  • 返回明确的 0 计数。
  • 针对性能和低处理成本进行了优化。
  • 简单易用。无需编写复杂的查询。
  • 验证输入参数并返回错误,使其更易于使用和调试。
  • 支持复杂查询,例如高级过滤和联接。
  • 不强制执行最小搜索区域。
  • 支持 COUNT 以外的其他聚合函数,例如 AVG、SUM 和 GROUP BY。
接口 四个预定义的 SQL 函数,可生成 COUNT 数据分析:单次计数、按类型计数、按地理位置计数、按 H3 单元格计数。JSON_OBJECT 会将参数传递给函数。 自行编写 SQL 来运行 COUNT、COUNT_IF、SUM 和 AVG. 等聚合函数。您可以使用 JOIN、GROUP BY、WHERE 等函数生成更多数据洞见。
限制 强制执行 40.0 米 x 40.0 米(1600 平方米)的最小搜索区域。只要满足最小搜索区域,函数就会返回结果,包括计数为 0。 计数为 0 的结果会从结果中省略(即排除该行)。
支持的属性过滤条件 地点计数函数过滤条件参数支持与直接查询属性过滤条件相同的参数,但以下参数除外:
  • 位置id
  • 地址组成部分
支持完整架构。