关于 Places Insights 数据和查询

地点数据分析数据

地点数据分析在 BigQuery 中提供完整数据集和抽样数据集

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

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

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

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

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

数据集架构

每个国家/地区的地点数据集架构包含两部分:

例如,如果您要处理西班牙 (ES) 的数据集,请同时引用核心架构和 ES 特有的架构。

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

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

查询地点数据分析数据

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

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

直接查询

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

地点数量函数查询

Places Count 函数可以返回地点 ID 列表,您可以使用该列表通过其他 GMP 产品(例如 Places APIPlaces UI Kit)查找各个地点的信息。

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

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

如果您不需要较低的结果数量,或者想获取除数量之外的其他数据洞见(例如 AVGSUMCOUNTIF),或者需要执行更复杂的查询(例如联接数据集),请直接查询数据。

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

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

地点数量函数 直接数据集查询
优势
  • 返回可用于查询其他 API 的地点 ID。
  • 可以返回任何数量。
  • 针对性能和低处理成本进行了优化。
  • 简单易用。无需编写复杂的查询。
  • 验证输入参数并返回错误,从而更易于使用和调试。
  • 支持高级过滤和联接等复杂查询。
  • 不强制执行最小搜索区域。
  • 除了 COUNT 之外,还支持其他聚合函数,例如 AVGSUMGROUP BY
接口 四种预定义的 SQL 函数,用于生成 COUNT 洞见:单次计数、按类型计数、按地理位置计数、按 H3 单元格计数。JSON_OBJECT 会将实参传递给函数。 编写自己的 SQL 来运行 COUNTCOUNT_IFSUMAVG. 等聚合函数。您还可以使用 JOINGROUP BYWHERE 等函数生成更多数据洞见。
限制 强制执行 40.0 米 x 40.0 米(1600 平方米)的最小搜索区域。即使汇总计数小于 5,只要满足最小搜索面积,函数也会返回结果。 系统会从结果中省略数量少于 5 的结果(即排除相应行)。
支持的属性过滤条件 “地点数”函数过滤条件参数支持与直接查询属性过滤条件相同的参数,但以下参数除外:
  • 地点:id
  • 地址组成部分
  • 营业时间
  • 电动汽车充电选项
  • 品牌
支持完整架构