术语连接

编辑

使用术语连接来增强矢量要素的属性,以便进行数据驱动样式和更丰富的工具提示内容。

以下矢量图层可以使用术语连接

  • 配置的 GeoJSON
  • 文档
  • EMS 边界

术语连接示例

编辑

等值区域图层示例使用术语连接来根据 Web 日志流量对世界各国进行着色。较深的阴影表示 Web 日志流量较多的国家,较浅的阴影表示流量较少的国家。

gs add cloropeth layer

术语连接的工作原理

编辑

术语连接使用共享键将矢量要素(左源)与 Elasticsearch 术语聚合(右源)的结果相结合。

等值区域图示例使用共享键ISO 3166-1 alpha-2 代码来连接世界各国和 Web 日志流量。ISO 3166-1 alpha-2 代码是一种国际标准,用于通过两个字母的国家代码来标识国家。例如,瑞典的 ISO 3166-1 alpha-2 代码为SE

terms join shared key config

左源

编辑

术语连接的左源是Elastic 地图服务 (EMS)世界各国。此源的矢量要素由 EMS 提供。您也可以使用自己的矢量要素。

在以下示例中,iso2属性定义了左源的共享键。

{
  geometry: {
    coordinates: [...],
    type: "Polygon"
  },
  properties: {
    name: "Sweden",
    iso2: "SE"
  },
  type: "Feature"
}

右源

编辑

右源使用 Kibana 示例数据集“示例 Web 日志”。在此数据集中,geo.src字段包含来源国的 ISO 3166-1 alpha-2 代码。

术语聚合geo.src对示例 Web 日志文档进行分组,并计算每个术语的指标。

METRICS 配置定义了两个指标聚合

  • 术语桶中所有文档的计数。
  • 术语桶中所有文档的“bytes”字段的平均值。
terms join metric config

右源不提供单个文档,而是提供术语聚合的指标。这些指标从以下示例 Web 日志文档计算得出。

{
  bytes: 1837,
  geo: {
    src: "SE"
  },
  timestamp: "Feb 28, 2019 @ 07:23:08.754"
},
{
  bytes: 971,
  geo: {
    src: "SE"
  },
  timestamp: "Feb 27, 2019 @ 08:10:45.205"
},
{
  bytes: 4277,
  geo: {
    src: "SE"
  },
  timestamp: "Feb 21, 2019 @ 05:24:33.945"
},
{
  bytes: 5624,
  geo: {
    src: "SE"
  },
  timestamp: "Feb 21, 2019 @ 04:57:05.921"
}

术语聚合为每个唯一的geo.src值创建一个桶。为桶中的所有文档计算指标。

以下显示了一个术语聚合响应示例。请注意key属性,它定义了右源的共享键。

{
  aggregations: {
    join: {
      buckets: [
        {
          doc_count: 4,
          key: "SE",
          avg_of_bytes: {
            value: 3177.25
          }
        },
        ...
      ]
    }
  }
}

使用右源的指标来增强左源

编辑

连接将每个术语聚合桶的指标添加到具有相应 ISO 3166-1 alpha-2 代码的世界国家要素。地图上不显示没有相应术语聚合桶的要素。

世界各国要素现在有两个附加属性

  • 源自该世界国家的 Web 日志流量计数
  • 源自该世界国家的 Web 日志流量的平均字节数

等值区域图示例使用 Web 日志流量的计数来按 Web 日志流量对各国进行符号化。