该函数用于在指定线段的两侧偏移指定距离,并返回偏移后的新线段。
line
:必选参数,表示要进行偏移的线段。可以是一个或多个线段组成的 FeatureCollection、GeometryCollection,或者一个单独的 LineString 几何要素。distance
:必选参数,表示偏移的距离,可以为正数或负数。距离值的单位与线段的坐标单位相同。options
:可选参数,表示偏移出现的情况,是一个对象,并包括以下属性:
units
:表示距离值的单位,可以为:'kilometers'、'miles'、'degrees'、'radians'、'nauticalmiles'。默认为'meters'。steps
:表示插值的点数,值越大,则插入的点越密集。默认值为 10。函数返回一个新的线段,即在原始输入线段的两侧偏移指定距离后得到的线段。新线段与原始线段的形状和坐标一致,只是与原始线段的位置不同。
var line = turf.lineString([[0, 0], [0, 10]]);
var offset = turf.lineOffset(line, 0.1, {units: 'kilometers'});
该示例偏移了一条由两个点组成的线段,距离值为 0.1 千米。函数返回一个新的线段,即偏移后的结果。