Geocoder 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.

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>

Example:

bbox=37.7902858,-122.4027371;37.7890649,-122.3993039