---
title: LngLatBounds
source: https://vjmap.com/doc/LngLatBounds.html
---

# LngLatBounds
一个`LngLatBounds`对象代表一个地理边界框，由其西南和东北经纬度点定义。

如果没有为构造函数提供参数，`null`则会创建一个边界框。

请注意，任何接受`LngLatBounds`对象作为参数或选项的方法也可以接受`Array`两个[LngLatLike][284]构造中的一个，并将执行隐式转换。这种灵活的类型记录为[LngLatBoundsLike][299]。

### Parameters
- `sw` **[LngLatLike][284] ?** 边界框的西南角。
- `ne` **[LngLatLike][284] ?** 边界框的东北角。

### Examples
```
var sw = new vjmap.LngLat(-73.9876, 40.7661);
var ne = new vjmap.LngLat(-73.9397, 40.8002);
var llb = new vjmap.LngLatBounds(sw, ne);
```

### setNorthEast
设置边界框的东北角

#### Parameters
- `ne` **[LngLatLike][284]**一个[LngLatLike][284]描述边界框的东北角对象。

返回**[LngLatBounds][285]** `this`

### setSouthWest
设置边界框的西南角

#### Parameters
- `sw` **[LngLatLike][284]**一个[LngLatLike][284]描述边框的西南角对象。

返回**[LngLatBounds][285]** `this`

### extend
扩展边界以包括给定的 LngLatLike 或 LngLatBoundsLike。

#### Parameters
- `obj` **( [LngLatLike][284] | [LngLatBoundsLike][299] )**要扩展到的对象

返回**[LngLatBounds][285]** `this`

### getCenter
返回与边界框角等距的地理坐标。

#### Examples
```
var llb = new vjmap.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
llb.getCenter(); // = LngLat {lng: -73.96365, lat: 40.78315}
```

返回**[LngLat][230]**边界框的中心。

### getSouthWest
返回边界框的西南角。

返回**[LngLat][230]**边界框的西南角。

### getNorthEast
返回边界框的东北角。

返回**[LngLat][230]**边界框的东北角。

### getNorthWest
返回边界框的西北角。

返回**[LngLat][230]**边界框的西北角。

### getSouthEast
返回边界框的东南角。

返回**[LngLat][230]**边界框的东南角。

### getWest
返回边界框的西边。

返回**`number`**边界框的西边。

### getSouth
返回边界框的南边。

返回**`number`**边界框的南边缘。

### getEast
返回边界框的东边。

返回**`number`**边界框的东边。

### getNorth
返回边界框的北边缘。

返回**`number`**边界框的北边缘。

### toArray
返回表示为数组的边界框。

#### Examples
```
var llb = new vjmap.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
llb.toArray(); // = [[-73.9876, 40.7661], [-73.9397, 40.8002]]
```

返回**`Array`< `Array`< `number`\>>**表示为数组的边界框，由表示为数字数组的边界的西南和东北坐标组成。

### toString
返回表示为字符串的边界框。

#### Examples
```
var llb = new vjmap.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
llb.toString(); // = "LngLatBounds(LngLat(-73.9876, 40.7661), LngLat(-73.9397, 40.8002))"
```

返回**`string`**边界框表示为格式字符串 `'LngLatBounds(LngLat(lng, lat), LngLat(lng, lat))'`。

### isEmpty
检查边界框是否为空/ `null`\- 类型框。

**`boolean`**如果边界已定义，则返回True，否则返回false。

### contains
检查点是否在边界框内。

#### Parameters
- `lnglat` 要检查的**[LngLatLike][284]**地理点。

#### Examples
```
var llb = new vjmap.LngLatBounds(
  new vjmap.LngLat(-73.9876, 40.7661),
  new vjmap.LngLat(-73.9397, 40.8002)
);

var ll = new vjmap.LngLat(-73.9567, 40.7789);

console.log(llb.contains(ll)); // = true
```

**`boolean`**如果点在边界框内，则返回True。

### convert
将数组转换为`LngLatBounds`对象。

如果`LngLatBounds`传入一个对象，该函数将原样返回它。

在内部，该函数调用`LngLat#convert`将数组转换为`LngLat`值。

#### Parameters
- `input` **[LngLatBoundsLike][299]**要转换的两个坐标数组，或`LngLatBounds`要返回的对象。

#### Examples
```
var arr = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
var llb = vjmap.LngLatBounds.convert(arr);
llb;   // = LngLatBounds {_sw: LngLat {lng: -73.9876, lat: 40.7661}, _ne: LngLat {lng: -73.9397, lat: 40.8002}}
```

返回**[LngLatBounds][285]**一个新`LngLatBounds`对象（如果发生转换）或原始`LngLatBounds`对象。