pointToLineDistance

描述

¥Description

计算给定点与直线上最近点之间的距离。有时也称为跨轨道距离。

¥Calculates the distance between a given point and the nearest point on a line. Sometimes referred to as the cross track distance.

参数

¥Parameters

名称	类型	描述
pt	特性<点> | 数组<number>	要素或几何图形
line	特性<LineString>	GeoJSON 要素或几何体
options?	对象	可选参数（默认值：）
options.units?	单位	支持所有有效的 Turf 单位（默认为 "kilometers"）
options.method?	string	是否基于测地线（椭球体）或平面（扁平）方法计算距离。有效选项为 'geodesic' 或 'planar'。(默认 "geodesic")

返回

¥Returns

number 点与线之间的距离

¥number distance between point and line

示例

¥Examples

var pt = turf.point([0, 0]);
var line = turf.lineString([
  [1, 1],
  [-1, 1],
]);

var distance = turf.pointToLineDistance(pt, line, { units: "miles" });
//=69.11854715938406

安装

¥Installation

$ npm install @turf/point-to-line-distance

import { pointToLineDistance } from "@turf/point-to-line-distance";
const result = pointToLineDistance(...);

$ npm install @turf/turf

import * as turf from "@turf/turf";
const result = turf.pointToLineDistance(...);