123456789101112131415161718192021222324252627282930313233343536373839 |
- import { Feature, Point, LineString, MultiLineString, Coord, Units } from "@turf/helpers";
- export interface NearestPointOnLine extends Feature<Point> {
- properties: {
- index?: number;
- dist?: number;
- location?: number;
- [key: string]: any;
- };
- }
- /**
- * Takes a {@link Point} and a {@link LineString} and calculates the closest Point on the (Multi)LineString.
- *
- * @name nearestPointOnLine
- * @param {Geometry|Feature<LineString|MultiLineString>} lines lines to snap to
- * @param {Geometry|Feature<Point>|number[]} pt point to snap from
- * @param {Object} [options={}] Optional parameters
- * @param {string} [options.units='kilometers'] can be degrees, radians, miles, or kilometers
- * @returns {Feature<Point>} closest point on the `line` to `point`. The properties object will contain three values: `index`: closest point was found on nth line part, `dist`: distance between pt and the closest point, `location`: distance along the line between start and the closest point.
- * @example
- * var 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]
- * ]);
- * var pt = turf.point([-77.037076, 38.884017]);
- *
- * var snapped = turf.nearestPointOnLine(line, pt, {units: 'miles'});
- *
- * //addToMap
- * var addToMap = [line, pt, snapped];
- * snapped.properties['marker-color'] = '#00f';
- */
- declare function nearestPointOnLine<G extends LineString | MultiLineString>(lines: Feature<G> | G, pt: Coord, options?: {
- units?: Units;
- }): NearestPointOnLine;
- export default nearestPointOnLine;
|