@turf/line-slice-along
Version:
Useful for extracting only the part of a route between two distances.
32 lines (29 loc) • 1.32 kB
text/typescript
import { Units } from '@turf/helpers';
import { Feature, LineString } from 'geojson';
/**
* Takes a {@link LineString|line}, a specified distance along the line to a start {@link Point},
* and a specified distance along the line to a stop point
* and returns a subsection of the line in-between those points.
*
* This can be useful for extracting only the part of a route between two distances.
*
* @function
* @param {Feature<LineString>|LineString} line input line
* @param {number} startDist distance along the line to starting point
* @param {number} stopDist distance along the line to ending point
* @param {Object} [options={}] Optional parameters
* @param {Units} [options.units='kilometers'] Supports all valid Turf {@link https://turfjs.org/docs/api/types/Units Units}
* @returns {Feature<LineString>} sliced line
* @example
* var line = turf.lineString([[7, 45], [9, 45], [14, 40], [14, 41]]);
* var start = 12.5;
* var stop = 25;
* var sliced = turf.lineSliceAlong(line, start, stop, {units: 'miles'});
*
* //addToMap
* var addToMap = [line, start, stop, sliced]
*/
declare function lineSliceAlong(line: Feature<LineString> | LineString, startDist: number, stopDist: number, options?: {
units?: Units;
}): Feature<LineString>;
export { lineSliceAlong as default, lineSliceAlong };