@turf/line-slice-along

What is @turf/line-slice-along?

@turf/line-slice-along is a module from the Turf.js library that allows you to slice a line segment from a given GeoJSON LineString based on start and stop distances along the line. This is useful for various geospatial operations where you need to extract a specific segment of a line based on distance measurements.

What are @turf/line-slice-along's main functionalities?

Slice a LineString

This feature allows you to slice a segment from a LineString based on start and stop distances. The code sample demonstrates how to use the `lineSliceAlong` function to extract a segment from a given LineString.

const turf = require('@turf/turf');

const line = turf.lineString([
  [-77.031669, 38.878605],
  [-77.029609, 38.881946],
  [-77.020339, 38.884084],
  [-77.025661, 38.885821],
  [-77.021884, 38.889563],
  [-77.019824, 38.892368]
]);

const start = 0.5; // start distance in kilometers
const stop = 2.5; // stop distance in kilometers

const slicedLine = turf.lineSliceAlong(line, start, stop);
console.log(JSON.stringify(slicedLine));

Other packages similar to @turf/line-slice-along

polyline

The 'polyline' package is used for encoding and decoding Google Maps Polylines. While it does not provide slicing functionality directly, it can be used in conjunction with other geospatial libraries to achieve similar results. It focuses more on the encoding and decoding of polyline data rather than slicing based on distances.

turf-line-distance

The 'turf-line-distance' package is another module from the Turf.js library that calculates the distance along a LineString. While it does not slice the line, it can be used to measure distances which can then be used to determine slicing points when combined with other Turf.js functions.

geolib

The 'geolib' package provides a variety of geospatial functions, including distance calculations and point transformations. It can be used to achieve similar slicing functionality by calculating distances and extracting segments, although it may require more manual implementation compared to the direct slicing provided by @turf/line-slice-along.

README

@turf/line-slice-along

lineSliceAlong

Takes a line, a specified distance along the line to a start 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.

Parameters

• line (Feature<LineString> | LineString) input line
• startDist number distance along the line to starting point
• stopDist number distance along the line to ending point
• units [string] can be degrees, radians, miles, or kilometers (optional, default kilometers)

Examples

var line = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "LineString",
    "coordinates": [
       [ 7.66845703125, 45.058001435398296 ],
      [ 9.20654296875, 45.460130637921004 ],
      [ 11.348876953125, 44.48866833139467 ],
      [ 12.1728515625, 45.43700828867389 ],
      [ 12.535400390625, 43.98491011404692 ],
      [ 12.425537109375, 41.86956082699455 ],
      [ 14.2437744140625, 40.83874913796459 ],
      [ 14.765625, 40.681679458715635 ]
    ]
  }
};
var start = 12.5;

var stop = 25;

var units = 'miles';

var sliced = turf.lineSliceAlong(start, stop, line, units);

//=line

//=sliced

Returns Feature<LineString> sliced line

---

This module is part of the Turfjs project, an open source module collection dedicated to geographic algorithms. It is maintained in the Turfjs/turf repository, where you can create PRs and issues.

Installation

Install this module individually:

$ npm install @turf/line-slice-along

Or install the Turf module that includes it as a function:

$ npm install @turf/turf