bbox

描述

bbox 是 Turf 的一个函数，用于计算给定几何对象的边界框（bounding box，缩写为 bbox），以确定它所在的矩形区域。

边界框是一个最小的矩形区域，完全包含给定的几何对象，通常用于进行空间数据查询和分析。

用法

var bbox = turf.bbox(geojson);

参数

• geojson：必须；表示要计算边界框的几何对象。

返回值

bbox 函数返回一个由四个数字组成的数组 [west, south, east, north] ，用来表示边界框的左、下、右、上四个边界。

var bbox = [-122.6819, 45.5231, -122.6786, 45.5254];

示例

var polygon = turf.polygon([[
  [-67.031021, 50.458296],
  [-67.031021, 52.634715],
  [-63.254658, 52.634715],
  [-63.254658, 50.458296],
  [-67.031021, 50.458296]
]]);
var bbox = turf.bbox(polygon);
// bbox = [-67.031021, 50.458296, -63.254658, 52.634715]

异常

• Invalid GeoJSON object：表示传入的 geojson 参数不是有效的 GeoJSON 对象。

注意事项

• bbox 函数只有在传入的几何对象中存在至少一个 "有效" 坐标时才能计算边界框。如果传入的几何对象为空，那么函数将抛出错误。
• 如果几何对象包含了多个部分，则 bbox 函数将返回一个包含所有部分的最小边框；如果每个部分的边框不同，则函数将返回一个容纳所有部分边框的最小边框。
• 经度应该在 [-180, 180] 范围内，纬度应该在 [-90, 90] 范围内。应该避免在计算过程中出现数值溢出的情况。

参考链接

• Turf.js - bbox