polygon

polygon 是Turf中用于创建多边形（polygon）的一个HELPER函数。它接受一个坐标数组作为输入，返回一个包含该多边形的GeoJSON对象。

参数

• coordinates：一个由至少三个坐标点组成的数组，表示多边形的边界。
  • 类型：Array。
  • 必选参数。

返回值

一个包含多边形的GeoJSON对象。返回的对象包含一个 type 属性，值为 'Feature'，以及一个 geometry 属性，其类型为 'Polygon'。这个对象还包含一个 properties 属性，其默认值为 {}。

示例

const polygon = require('@turf/helpers').polygon;

const coordinates = [[[0, 0], [0, 1], [1, 1], [1, 0], [0, 0]]];
const polyGeoJSON = polygon(coordinates);

console.log(polyGeoJSON);
// 输出: {"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[0,0],[0,1],[1,1],[1,0],[0,0]]]},"properties":{}}

异常

• 如果 coordinates 参数未提供或不是一个有效的数组，则会抛出类型错误(TypeError)异常。

实现细节

• polygon() 函数会默认将最后一个坐标点和第一个坐标点连接形成封闭多边形。
• 如果坐标点数组中的任何一个坐标点不是一个有效的点，则会抛出类型错误(TypeError)异常。
• 目前， polygon() 只支持二维坐标系，不能处理三维坐标。