关于 Places Insights 数据和查询

地点数据分析数据

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

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

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

阿姆斯特丹 (NL) 赫尔辛基 (FI) 普罗夫迪夫 (BG)
安卡拉 (TR) 香港 (HK) 里法 (BH)
阿雷基帕 (PE) 雅加达 (ID) 罗马 (IT)
雅典 (GR) 吉达 (SA) 圣地亚哥 (CL)
巴德加斯坦 (AT) 约翰内斯堡 (ZA) 圣保罗 (BR)
柏林 (DE) 吉隆坡 (MY) 沙迦 (AE)
布尔诺 (CZ) 里斯本 (PT) 新加坡 (SG)
布鲁塞尔 (BE) 伦敦 (GB) 斯德哥尔摩 (SE)
布加勒斯特 (RO) 卢赛尔 (QA) 悉尼 (AU)
布宜诺斯艾利斯 (AR) 马德里 (ES) 台北 (TW)
釜山 (KR) 马尼拉 (PH) 特拉维夫-雅法 (IL)
开罗 (EG) 麦德林 (CO) 东京 (JP)
清迈 (TH) 墨西哥城 (MX) 多伦多 (CA)
哥本哈根 (DK) 孟买 (IN) 华沙 (PL)
科克 (IE) 纽约市 (US) 惠灵顿 (NZ)
德布勒森 (HU) 奥斯陆 (NO) 苏黎世 (CH)
河内 (VN) 巴黎 (FR)

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

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

数据集架构

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

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

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

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

查询地点数据分析数据

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

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

直接查询

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

地点计数函数查询

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

Places Count 函数不会强制执行汇总阈值,而是强制执行 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
  • 地址组件
  • 营业时间
  • 电动汽车充电选项
  • 品牌
支持完整架构