Routing API Developer's Guide

GeoBoundingBoxType

A GeoBoundingBoxType defines a rectangular area in a geographic coordinate system. This type is derived from the abstract base type GeoAreaType.

Figure 1. GeoBoundingBoxType

As the bounding box is specified by its top-left and bottom-right corner of the box, it is not necessarily the smallest rectangle spanned by these two points; it is possible to define bounding boxes that are wider than 180° or higher than 90° (for example, by setting the longitude of top-left corner to a bigger value than the longitude of the bottom-right corner).

A bounding box with longitude of ‑180° for the top-left corner and a longitude of 180° for the bottom-right corner constructs an area that encircles the globe whereas a bounding box with the same longitude values for both corners constructs a bounding box of width 0°.

The GeoBoundingBoxType has the following attributes:

  • TopLeft

    Top-left corner of the rectangular area.

    • Latitude

      WGS-84 / degrees with (-90 <= Latitude <=90)

    • Longitude

      WGS-84 / degrees with (-180 <= Longitude <=180)

    • Altitude

      Altitude in meters (optional)

  • BottomRight

    Bottom-right corner of the rectangular area.

    • Latitude

      WGS-84 / degrees with (-90 <= Latitude <=90)

    • Longitude

      WGS-84 / degrees with (-180 <= Longitude <=180)

    • Altitude

      Altitude in meters (optional)

Query Parameter Representation

A BoundingBoxType is represented in a compact format if used as query parameter:

<TopLeft.Latitude> + "," + <TopLeft.Longitude> + ";" + <BottomRight.Latitude> + "," + <BottomRight.Longitude>

If possible (in other words, if there is no risk of name clashes) the preferred name for the parameter of a BoundingBoxType element is "bbox".

Example:

bbox=37.7902858,-122.4027371;37.7890649,-122.3993039