UNPKG

@turf/line-slice-along

Version:

Useful for extracting only the part of a route between two distances.

32 lines (29 loc) 1.32 kB
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 };