当前位置: 首页 > 工具软件 > Feature.js > 使用案例 >

turf.js API功能讲解

朱浩大
2023-12-01
turf.js(地理空间分析函数库) - http://turfjs.org/特点体积小
模块化加载不同功能
运行快速,不依赖后端
相关API基础API操作数据获取getCoord从点数据中获取坐标信息
getCoords从要素、几何对象或数组获取坐标信息
getGeom从要素或几何对象获取geometry信息
getType获取GeoJSON对象的类型
getCluster获取聚类信息
coord操作coordAll从Geojson对象中提取所有的经纬度数据并封装为数组
coordEach遍历Geojson对象中所有的经纬度数据,类似Array.forEach()
coordReduce类似Array.reduce()
feature操作featureEach遍历Geojson对象中的所有feature,类似Array.forEach()
featureReduce类似Array.reduce()
flatten操作flattenEach
flattenReduce
geom操作geomEach遍历GeoJSON对象中的每个几何,类似于Array.forEach()
geomReduce类似Array.reduce()
segment操作segmentEach迭代任何GeoJSON对象中的2个顶点线段,类似于Array.forEach()(Multi)Point几何不包含线段,因此在此操作期间将忽略它们。
segmentReduce减少任何GeoJSON对象中的2顶点线段,类似于Array.reduce()(Multi)Point几何不包含线段,因此在此操作期间将忽略它们。
prop操作propEach遍历GeoJSON对象中的属性,类似于Array.forEach()
propReduce类似Array.reduce()
cluster操作clusterEach
clusterReduce
测量计算计算方位角bearing两个点之间的地理方位,即与北线成0度的度数(-180到180之间)
rhumbBearing取两个点,并沿Rhumb线找到它们之间的方位角,即以度为单位以北线为起点(0度)的度数
计算中心点或者质心center输入一系列geojson元素,返回绝对中心点
centerOfMass接受任何要素或要素集合,获取其多边形质心
centroid选取一个或多个要素,并使用所有顶点的平均值计算质心。 在计算一组多边形的质心时,这会减少孤立区域的影响。
计算距离destination输入一个点,并以度,弧度,英里或公里为单位,计算目标点的位置。
distance计算两点之间的距离,以度,弧度,英里或公里为单位。
length输入线要素信息,计算实际距离长度
pointToLineDistance返回Point与LineString之间的最小距离
计算面积area输入一个或多个geojson要素,求出包含面积
计算边框bbox接受一组geojson要素,计算所有输入要素的bbox,然后返回一个矩形边界框。
bboxPolygon使用bbox并返回等效的多边形。
envelope接受任意数量的点要素,并返回一个包含所有顶点的矩形面。
square输入bbox,获取最小正方形框
greatCircle输入两个点,计算最匹配的圆对应圆环,以lineString的方式返回
计算目标点along接受LineString并返回沿线指定距离的Point。
midpoint取两个点,并在它们之间的中间返回一个点。 中点是通过测地线计算的。
rhumbDestination获取给定方位角和距离的目标点
pointOnFeature输入Feature或FeatureCollection,返回一个在要素表面上的Point。
polygonTangents从一个点寻找多边形的切线对应的点。
坐标改变cleanCoords从任何GeoJSON Geometry中删除冗余坐标。
flip坐标翻转,例如[x, y]经过翻转后为[y, x]
rewind输入lineString或者polygon数据,逆时针输出相关结果
round四舍五入,输入数字及保留小数位数,默认保留0位
truncategeojson数据经纬度信息小数点位数限制,避免数据过长影响性能
图形操作clonegeojson数据深拷贝,比JSON.stringify + JSON.parse 快3到4倍
simplifygeojson数据简化
concave根据一组点数据,生成包含的多边形
bboxClip依据bbox对polygon进行裁剪
bezierSpline输入一条线,获取近似的贝塞尔曲线
buffer计算给定半径的输入要素的缓冲区。 
circle根据中心点、半径等参数创建圆多边形
convex接受Feature或FeatureCollection,返回凸包Polygon。
dissolve分解多边形要素的FeatureCollection,并通过可选的属性name:value进行过滤。
intersect取两个多边形并找到它们的交点。 如果他们共享边界,则返回边界;否则,返回边界。 如果它们不相交,则返回undefined。
lineOffset给定一条直线返回偏移指定距离的直线。
tesselate给定要素,将其切分为多个三角形https://github.com/mapbox/earcut
transformRotate旋转:围绕其质心或给定的轴心点旋转指定角度
transformTranslate平移:在提供的方向角上沿Rhumb线移动指定距离的任何geojson特征或几何。Rhumb:恒向线或等角航线
transformScale缩放
difference输入两个面元素,返回差异部分
union两个或者多个多边形合并
voronoi输入bbox及多个点数据,生成泰森多边形
要素转换combine将Point,LineString或Polygon要素的FeatureCollection转换为为MultiPoint,MultiLineString或MultiPolygon要素。
explode将polygon转换为多个点要素
flatten展平:将多个要素合并为一个要素
lineToPolygon将(Multi)LineString转换为Polygon。
polygonize将(Multi)LineString转换为Polygon?与上一个类似
polygonToLine将polygon转换为(Multi)LineString或将MultiPolygon转换为(Multi)LineString的FeatureCollection。
几何体/feature/collection转换坐标=>featurepoint输入一个点坐标,转换为feature
lineString输入坐标数组,转换为一条LineString
polygon输入坐标数组,转换为Polygon
multiPoint输入坐标数组,转换为MultiPoint
multiLineString输入坐标数组,转换为一条MultiLineString
multiPolygon输入坐标数组,转换为MultiPolygon
feature=>collectionfeatureCollection输入一个或多个feature,返回featureCollection
geometryCollection输入一个或多个GeoJson几何体 ,返回"GeometryCollection"类型feature
几何体对象=>featurefeature输入GeoJSON几何体对象,返回相应feature
随机数据randomPosition返回固定范文内的随机位置
randomPoint获取固定范围内若干个随机点
randomLineString获取固定范围内若干条随机线
randomPolygon获取固定范围内若干个随机面
数据抽样sample从数据中随机抽取若干数据。
数据插值interpolate输入一组点,使用反距离权重(IDW)方法在网格上估计其“属性”值进行显示
isobands取得具有z值和值中断数组的点要素的网格FeatureCollection,并生成填充轮廓等值带。
isolines使用具有z值和值中断数组的点要素的网格FeatureCollection并生成等值线。
planepoint取一个三角形平面作为一个多边形,并在该三角形内获取一个点,并返回该点的z值。 多边形应具有属性a,b和c,用于定义其三个角的值。 或者,如果未将每个三角形点的z值作为属性提供,则可以通过其各自的第三坐标提供z值。
tin取得一组点,然后创建一个不规则三角剖分网络(简称TIN),以多边形集合的形式返回。 这些通常用于开发高程等高线图或阶梯式热可视化。
空间连接pointsWithinPolygon查找属于多边形的点。
tag获取一组点和一组多边形并执行空间连接。
网格生成hexGrid六边形网格:取一个边界框和该单元格的直径,并返回在“奇数”垂直网格中对齐的,平顶六边形或三角形(多边形特征)的FeatureCollection。
pointGrid点网格:通过边界框FeatureCollection或Feature创建点网格。
squareGrid矩形网格:从边界框Feature或FeatureCollection创建一个正方形网格。
triangleGrid三角形网格:获取边界框和像元深度,并在网格中返回一组三角形多边形。
数据分类nearestPoint输入一系列点和目标点,寻找与目标点最接近的点
数据聚类collect不同元素间属性合并:将点的FeatureCollection中的指定属性合并到多边形的FeatureCollection中。 给定点上的inProperty和多边形的outProperty,它将找到每个多边形内的每个点,收集这些点的inProperty值,并将它们作为数组添加到多边形上的outProperty。
clustersDbscan根据DBSCAN数据聚类算法,输入一组点并将其划分为集群
clustersKmeans使用k-means算法,输入一组点使用k均值将它们划分为集群
数据类型限制collectionOf限制输入的FeatureCollection的类型
geojsonType限制输入的Geojson的类型
featureOf限制输入的Feature类型
containsNumber判断数据是否包含数字
几何关系判断booleanClockwise判断数据是否是顺时针方向
booleanCrosses判断两个对象是否相交及相交区域是否小于两个对象
booleanDisjoint如果两个对象没有交集,则返回True
booleanEqual确定两个相同类型的几何图形是否具有相同的X,Y坐标值
booleanOverlap判断两个几何对象是否相交
booleanParallel判断两条线段是否平行
booleanPointInPolygon判断点是否在面内
booleanPointOnLine判断点是否在线上
booleanContains判断第一个对象是否完全包含第二个对象
booleanWithin判断第二个对象是否在第一个对象上
单位换算bearingToAzimuth方向角转换
convertArea面积单位转换。 有效单位:公里,公里,米,米,厘米,毫米,英亩,英里,码,英尺,英寸等
convertLength长度单位转换。 有效单位:英里,海里,英寸,码,米,米,公里,厘米,英尺
degreesToRadians将角度转换为弧度
lengthToRadians将实际单位的距离测量值(假设是球形地球)转换为弧度。实际单位:英里,海里,英寸,码,米,米,公里,厘米,英尺
lengthToDegrees将实际单位中的距离测量值(假设是球形地球)转换为度数。实际单位:英里,海里,英寸,码,米,米,厘米,公里,英尺
radiansToLength将弧度转换为其他单位的距离值
radiansToDegrees将弧度转换为角度度数
toMercator将WGS84 GeoJSON对象转换为Mercator(EPSG:900913)投影
toWgs84将Mercator(EPSG:900913)GeoJSON对象转换为WGS84投影
其他获取相交点或线kinks接受linestring,multi-linestring,multi-polygon或polygon,返回所有自相交处的点。
lineIntersect输入LineString或Polygon GeoJSON,返回相交点。
lineOverlap输入LineString或Polygon,返回两个要素之间的重叠线。
创建圆弧或扇形lineArc输入一个点及相关参数,创建一段圆弧
sector输入一个点及相关参数,创建一个扇形polygon
线段分割lineChunk将LineString分割成指定长度的线段。 如果该行短于段长度,则返回原始行。
lineSegment将面要素转换为两条线要素
lineSlice输入一个线段,一个起点和终点。返回中间的线段
lineSliceAlong输入一个线段,一个起点距离和一个终点距离。返回中间的线段
lineSplitlineString分割:通过另一个GeoJSON要素分割LineString。
nearestPointOnLine输入一个Point和一个LineString,计算位于(Multi)LineString上距离最近的Point。
mask接受任何类型的多边形和可选的蒙版,并返回带有孔的多边形外环。
shortestPath输入起点、终点和其他元素。返回一条最短路径
unkinkPolygon取得一个扭曲的多边形,并返回没有扭曲的多边形的要素集合。 内部使用simplepolygon。
 类似资料: