ST_OffsetCurve
上一页  7.14. 几何处理  下一页

名称

ST_OffsetCurve — 返回与输入线给定距离和侧面的偏移线。

概要

geometry ST_OffsetCurve(geometry line, float signed_distance, text style_parameters='');

描述

返回与输入线给定距离和侧面的偏移线。返回几何图形的所有点与输入几何图形的距离都不超过给定的距离。可用于计算中心线周围的平行线。

对于正距离，偏移在线的左侧，并保持相同的方向。对于负距离，偏移在线的右侧，并且方向相反。

距离的单位以空间参考系统的单位来衡量。

请注意，对于某些拼图形状的输入几何图形，输出可能是 MULTILINESTRING 或 EMPTY。

可选的第三个参数允许指定一个以空格分隔的键=值对列表，以调整操作，如下所示：

  • 'quad_segs=#'：用于近似四分之一圆的线段数（默认为 8）。

  • 'join=round|mitre|bevel'：连接样式（默认为“round”）。“miter” 也被接受作为“mitre”的同义词。

  • 'mitre_limit=#.#'：斜接比率限制（仅影响斜接连接样式）。“miter_limit”也被接受作为“mitre_limit”的同义词。

由 GEOS 模块执行。

GEOS 3.11 中行为已更改，因此对于正偏移和负偏移，偏移曲线现在具有与输入线相同的方向。

可用性：2.0

增强功能：2.5 - 添加了对 GEOMETRYCOLLECTION 和 MULTILINESTRING 的支持

[Note]

此函数忽略 Z 维度。即使在 3D 几何图形上使用，它也始终给出 2D 结果。

示例

计算道路周围的开放缓冲区

SELECT ST_Union(
 ST_OffsetCurve(f.geom,  f.width/2, 'quad_segs=4 join=round'),
 ST_OffsetCurve(f.geom, -f.width/2, 'quad_segs=4 join=round')
) as track
FROM someroadstable;

15, 'quad_segs=4 join=round' 原始线及其偏移 15 个单位。

SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)'),
    15, 'quad_segs=4 join=round'));

output

LINESTRING(164 1,18 1,12.2597485145237 2.1418070123307,
    7.39339828220179 5.39339828220179,
    5.39339828220179 7.39339828220179,
    2.14180701233067 12.2597485145237,1 18,1 195)

-15, 'quad_segs=4 join=round' 原始线及其偏移 -15 个单位

SELECT ST_AsText(ST_OffsetCurve(geom,
    -15, 'quad_segs=4 join=round')) As notsocurvy
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

notsocurvy

LINESTRING(31 195,31 31,164 31)

双重偏移以获得更弯曲的效果，请注意，第一个会反转方向，因此 -30 + 15 = -15

SELECT ST_AsText(ST_OffsetCurve(ST_OffsetCurve(geom,
    -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')) As morecurvy
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

morecurvy

LINESTRING(164 31,46 31,40.2597485145236 32.1418070123307,
35.3933982822018 35.3933982822018,
32.1418070123307 40.2597485145237,31 46,31 195)

双重偏移以获得更弯曲的效果，结合规则偏移 15 以获得平行线。与原始线叠加。

SELECT ST_AsText(ST_Collect(
    ST_OffsetCurve(geom, 15, 'quad_segs=4 join=round'),
    ST_OffsetCurve(ST_OffsetCurve(geom,
    -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')
    )
) As parallel_curves
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

parallel curves

MULTILINESTRING((164 1,18 1,12.2597485145237 2.1418070123307,
7.39339828220179 5.39339828220179,5.39339828220179 7.39339828220179,
2.14180701233067 12.2597485145237,1 18,1 195),
(164 31,46 31,40.2597485145236 32.1418070123307,35.3933982822018 35.3933982822018,
32.1418070123307 40.2597485145237,31 46,31 195))

15, 'quad_segs=4 join=bevel' 与原始线一起显示

SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)'),
        15, 'quad_segs=4 join=bevel'));

output

LINESTRING(164 1,18 1,7.39339828220179 5.39339828220179,
    5.39339828220179 7.39339828220179,1 18,1 195)

15,-15 收集，join=mitre mitre_limit=2.1

SELECT ST_AsText(ST_Collect(
    ST_OffsetCurve(geom, 15, 'quad_segs=4 join=mitre mitre_limit=2.2'),
    ST_OffsetCurve(geom, -15, 'quad_segs=4 join=mitre mitre_limit=2.2')
    ) )
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

output

MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),
    (31 195,31 31,164 31))

另请参阅

ST_Buffer