关于 Places Insights 数据和查询

地点数据分析数据

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

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

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

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

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

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

数据集架构

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

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

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

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

查询地点数据分析数据

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

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

直接查询

直接查询数据会强制执行汇总阈值。只有当查询汇总了至少 5 个地点时,系统才会返回结果。例如,如果搜索条件结果的计数为 0、1、2、3 或 4,则该结果会从响应中省略。例如,如果查询给定区域中的餐厅总数,则仅当总数不低于 5 时,系统才会返回回答,否则不会返回回答。

Places Count 函数查询

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

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

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

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

如果您需要知道结果数量是否较少或为零,或者需要检索个别地点信息(例如地点名称或地址),请使用这些函数进行查询。

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

地点计数函数 直接数据集查询
优势
  • 返回可用于查询其他 API 的地点 ID。
  • 可以返回任意数量。
  • 针对性能和低处理成本进行了优化。
  • 简单易用。无需编写复杂的查询。
  • 验证输入参数并返回错误,使其更易于使用和调试。
  • 支持高级过滤和联接等复杂查询。
  • 不强制执行最小搜索区域。
  • 支持 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 平方米)的最小搜索区域。只要满足最小搜索区域要求,即使汇总计数小于 5,函数也会返回结果。 计数小于 5 的结果会从结果中省略(即排除相应行)。
支持的属性过滤条件 地点计数函数过滤条件参数支持与直接查询属性过滤条件相同的过滤条件,但以下情况除外:
  • 位置id
  • 地址组成部分
支持完整架构。