Bounding Boxes

A bounding box is a rectangular area defined by two longitudes and two latitudes. Some operations allow using a bounding box to define an area of search or interest, instead of a single point.

These bounding boxes can be created by the client, taking the shape of a square or rectangle, and then used in the API to perform operations such as reverse geocoding.

For convenience, the API also provides an endpoint to create a bounding box around a location. The shape of this bounding box is always a square, with the location in the center.

POST /maps/geocoder/v1/bbox?size=1000
[ -0.143114, 51.538792 ]

Optional arguments:

• size: The size of the bounding box sides in meters. Defaults to 500.

Response:

{
    "bbox": [
        -0.146725,
        51.536546,
        -0.139503,
        51.541038
    ]
}

Tip

The bounding box is represented as an array with the west, south, east and north values.

The bounding box can then be used in other operations, such as reverse geocoding.