Name
ST_OffsetCurve — 返回从输入线到给定距离和侧边的偏移线。
Synopsis
geometry ST_OffsetCurve(geometry line, float signed_distance, text style_parameters='');
描述
从输入线返回给定距离和边上的偏移线。返回的几何图形的所有点与输入几何图形之间的距离不超过给定距离。用于计算围绕中心线的平行线。
对于正距离，偏移位于输入线的左侧，并保持相同的方向。对于负距离，它位于右侧，方向相反。
距离单位是以空间参考系为单位来测量的。
请注意，对于某些拼图形状的输入几何图形，输出可以是MULTILINESTRING或空。
可选的第三个参数允许指定一组空格分隔的键=值对来调整操作，如下所示：
‘quad_segs=#’：用于近似四分之一圆的线段数(默认为8)。
‘JOIN=ROUND|MITRE|BEVELL’：连接样式(默认为“ROUND”)。‘miter’也被认为是‘mitre’的同义词。
‘Mitre_Limit=#.#’：斜接比例限制(仅影响斜接样式)。‘MITER_LIMIT’也可以作为‘MITRE_LIMIT’的同义词。
由GEOS模块执行。
可用性：2.0
增强版：增加了2.5版对地球测量组合和多线串接的支持
![[Note]](images/note.png) | |
此函数忽略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=圆形’原始线及其偏移单位
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，联接=斜接_限制=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))
|