Legacy
Mapbox.js is no longer in active development. To learn more about our newer mapping tools see Mapbox GL JS.
LatLngBounds
Represents a rectangular geographical area on a map.
var southWest = L.latLng(40.712, -74.227),
northEast = L.latLng(40.774, -74.125),
bounds = L.latLngBounds(southWest, northEast);
All Leaflet methods that accept LatLngBounds objects also accept them in a simple Array form (unless noted otherwise), so the bounds example above can be passed like this:
map.fitBounds([
[40.712, -74.227],
[40.774, -74.125]
]);
Creation
Factory | Description |
---|---|
L.latLngBounds(
|
Creates a latLngBounds object by defining south-west and north-east corners of the rectangle. |
L.latLngBounds(
|
Creates a LatLngBounds object defined by the geographical points it contains. Very useful for zooming the map to fit a particular set of locations with fitBounds. |
Methods
Method | Returns | Description |
---|---|---|
extend(
|
this |
Extends the bounds to contain the given point or bounds. |
getSouthWest() |
LatLng |
Returns the south-west point of the bounds. |
getNorthEast() |
LatLng |
Returns the north-east point of the bounds. |
getNorthWest() |
LatLng |
Returns the north-west point of the bounds. |
getSouthEast() |
LatLng |
Returns the south-east point of the bounds. |
getWest() |
Number |
Returns the west longitude of the bounds. |
getSouth() |
Number |
Returns the south latitude of the bounds. |
getEast() |
Number |
Returns the east longitude of the bounds. |
getNorth() |
Number |
Returns the north latitude of the bounds. |
getCenter() |
LatLng |
Returns the center point of the bounds. |
contains(
|
Boolean |
Returns true if the rectangle contains the given one. |
contains(
|
Boolean |
Returns true if the rectangle contains the given point. |
intersects(
|
Boolean |
Returns true if the rectangle intersects the given bounds. |
equals(
|
Boolean |
Returns true if the rectangle is equivalent (within a small margin of error) to the given bounds. |
toBBoxString() |
String |
Returns a string with bounding box coordinates in a 'southwest_lng,southwest_lat,northeast_lng,northeast_lat' format. Useful for sending requests to web services that return geo data. |
pad(
|
LatLngBounds |
Returns bigger bounds created by extending the current bounds by a given percentage in each direction. |
isValid()
|
Boolean |
Returns true if the bounds are properly initialized. |