跳到主要内容

Circle 处理器

将圆形(circle)形状定义转换为近似该圆形的正多边形(regular polygon)。

参数必填默认值描述
field是-解释为圆形的字段。可以是 WKT 格式的字符串,或 GeoJSON 格式的 map。
target_field否field分配多边形形状的目标字段。默认情况下原字段被就地更新。
ignore_missing否false如果为 true 且字段不存在,处理器将静默退出而不修改文档。
error_distance是-生成的内切圆心到边的距离与圆半径之间的差值(对 geo_shape 以米为单位,对 shape 为无单位值)。
shape_type是-处理圆形时使用的字段映射类型:geo_shape 或 shape。
description否-处理器的描述。有助于说明该处理器或其配置的用途。
if否-有条件地执行处理器。参阅有条件地运行处理器。
ignore_failure否false忽略处理器的失败。参阅处理管道失败。
on_failure否-处理器的失败处理。参阅处理管道失败。
tag否-处理器的标识符。有助于调试和指标统计。

示例​

创建 circles 索引并定义管道:

PUT circles
{
"mappings": {
"properties": {
"circle": {
"type": "geo_shape"
}
}
}
}

PUT _ingest/pipeline/polygonize_circles
{
"description": "translate circle to polygon",
"processors": [
{
"circle": {
"field": "circle",
"error_distance": 28.0,
"shape_type": "geo_shape"
}
}
]
}
提示

使用上述管道,我们可以尝试向 circles 索引写入文档。圆形可以表示为 WKT 圆形或 GeoJSON 圆形。生成的多边形将使用与输入圆形相同的格式进行表示和索引:WKT 圆形会被转换为 WKT 多边形,GeoJSON 圆形会被转换为 GeoJSON 多边形。

包含极点(pole)的圆形不受支持。

以 WKT 格式定义的圆形示例​

在此示例中,写入一个以 WKT 格式定义的圆形。

PUT circles/_doc/1?pipeline=polygonize_circles
{
"circle": "CIRCLE (30 10 40)"
}

GET circles/_doc/1

上述索引请求的响应:

{
"found": true,
"_index": "circles",
"_id": "1",
"_version": 1,
"_seq_no": 22,
"_primary_term": 1,
"_source": {
"circle": "POLYGON ((30.000365257263184 10.0, 30.000111397193788 10.00034284530941, 29.999706043744222 10.000213571721195, 29.999706043744222 9.999786428278805, 30.000111397193788 9.99965715469059, 30.000365257263184 10.0))"
}
}

以 GeoJSON 格式定义的圆形示例​

在此示例中,写入一个以 GeoJSON 格式定义的圆形。

PUT circles/_doc/2?pipeline=polygonize_circles
{
"circle": {
"type": "circle",
"radius": "40m",
"coordinates": [30, 10]
}
}

GET circles/_doc/2

上述索引请求的响应:

{
"found": true,
"_index": "circles",
"_id": "2",
"_version": 1,
"_seq_no": 22,
"_primary_term": 1,
"_source": {
"circle": {
"coordinates": [
[
[30.000365257263184, 10.0],
[30.000111397193788, 10.00034284530941],
[29.999706043744222, 10.000213571721195],
[29.999706043744222, 9.999786428278805],
[30.000111397193788, 9.99965715469059],
[30.000365257263184, 10.0]
]
],
"type": "Polygon"
}
}
}

关于精度的说明​

表示圆形的多边形的精度由 error_distance 定义。该差值越小,多边形就越接近完美的圆形。

下表旨在帮助说明不同输入下,圆形的半径如何影响生成的多边形边数。

多边形的最小边数为 4,最大边数为 1000。

error_distance半径(米)多边形边数
1.001.04
1.0010.014
1.00100.045
1.001000.0141
1.0010000.0445
1.00100000.01000

原文链接