destination

简介

Turf的destination函数用于将一个地点（起点）沿着一个方向和距离移动，得到另一个地点（终点）的位置信息。

语法

turf.destination(origin, distance, bearing, options)

参数

• origin：起点坐标点，格式为[经度，纬度]的数组。
• distance：极地距离（单位为千米）。
• bearing：正北方向的逆时针角度（度数）。
• options：可选参数。

可选参数

• options.units：距离的单位，默认为千米。
• options.properties：一个包含自定义属性的对象。

示例

const origin = [-75.343, 39.984];
const distance = 10;
const bearing = 180;

const options = {
  units: 'kilometers',
  properties: {
    name: 'destination point'
  }
};

const destination = turf.destination(origin, distance, bearing, options);

• origin表示起点为经度为-75.343，纬度为39.984的点。
• distance表示要移动的距离为10千米。
• bearing表示要沿着正南方向移动。
• options指定了距离的单位为千米，并在终点处添加了自定义属性名为“name”的属性。
• destination为得到的终点位置。

返回值

destination函数返回经过移动后的终点坐标点，格式为[经度，纬度]的数组。

异常

• 如果输入的起点坐标、距离或逆时针角度未指定，则函数将抛出“Error: Required parameter is missing”的异常。
• 如果距离值小于等于0，则函数将抛出“Error: Distance must be greater than 0”的异常。

许可证

MIT许可证

作者

Turfjs团队