Leaflet API - LatLngBounds 经纬度边界中文文档

发布时间: 2022-10-13 所属分类: 文章标签:

当前位置：

麻辣GIS » GIS手册 » Leaflet中文API手册（V1.9） » Leaflet API - LatLngBounds 经纬度边界中文文档

本文介绍下 Leaflet 中 LatLngBounds 经纬度边界 API的详细使用说明。

LatLngBounds 经纬度边界 API 调用方法

在地图上代表一个矩形的地理区域。

使用示例

var corner1 = L.latLng(40.712, -74.227),
corner2 = L.latLng(40.774, -74.125),
bounds = L.latLngBounds(corner1, corner2);

所有接受 LatLngBounds 对象的 Leaflet 方法也接受它们的简单数组形式（除非另有说明），所以上面的边界例子可以这样传递:

map.fitBounds([
    [40.712, -74.227],
    [40.774, -74.125]
]);

注意：如果该地区跨越了反子午线（经常与国际日期变更线混淆），你必须指定[-180, 180]度经度 范围之外 的角。

注意 LatLngBounds 没有继承自Leaflet的 Class 对象，这意味着新的类不能继承自它，新的方法也不能用 include 函数添加到它。

Creation

构造函数	说明
`L.latLngBounds(<LatLng> corner1, <LatLng> corner2)`	通过定义矩形的两个斜对角，创建一个 `LatLngBounds` 对象。
`L.latLngBounds(<LatLng[]> latlngs)`	创建一个由其包含的地理点定义的 `LatLngBounds` 对象。对于用 `fitBounds` 缩放地图以适应一组特定的位置非常有用。

Methods 方法

方法	返回值	说明
`extend(<LatLng> latlng)`	`this`	扩展边界以包含给定的点
`extend(<LatLngBounds> otherBounds)`	`this`	扩展边界以包含给定的边界
`pad(<Number> bufferRatio)`	`LatLngBounds`	返回通过在每个方向上以给定的比率扩展或缩减当前边界而创建的边界。例如，比率为 0.5 时，界线在每个方向上都会延伸 50% 。负值将缩减边界。
`getCenter()`	`LatLng`	返回边界的中心点。
`getSouthWest()`	`LatLng`	返回边界的西南点。
`getNorthEast()`	`LatLng`	返回边界的东北点。
`getNorthWest()`	`LatLng`	返回边界的西北点。
`getSouthEast()`	`LatLng`	返回边界的东南点。
`getWest()`	`Number`	返回边界的西经度
`getSouth()`	`Number`	返回边界的南纬度
`getEast()`	`Number`	返回边界的东经度
`getNorth()`	`Number`	返回边界的北纬度
`contains(<LatLngBounds> otherBounds)`	`Boolean`	如果该矩形包含给定的矩形，则返回 `true` 。
`contains(<LatLng> latlng)`	`Boolean`	如果矩形包含给定的点，则返回 `true` 。
`intersects(<LatLngBounds> otherBounds)`	`Boolean`	如果矩形与给定的边界相交，返回 `true` 。如果两个边界至少有一个共同点，则它们相交。
`overlaps(<LatLngBounds> otherBounds)`	`Boolean`	如果矩形与给定的边界重叠，返回 `true` 。如果两个边界的交点是一个区域，那么它们就会重叠。
`toBBoxString()`	`String`	返回一个包含'southwest_lng、southwest_lat、northeast_lng、northeast_lat'格式的包围盒坐标的字符串。对于向返回地理数据的网络服务发送请求很有用。
`equals(<LatLngBounds> otherBounds, <Number> maxMargin?)`	`Boolean`	如果矩形与给定的边界相当（在一个小的误差范围内），则返回 `true` 。误差范围可以通过设置 `maxMargin` 为一个小数字来重写。
`isValid()`	`Boolean`	如果边界被正确初始化，则返回 `true` 。