within

The within action allows for returning data within a variety of different geometrical regions. Results using the within action are not returned in any particular order unless specific in the query params. The following supported geometries are supported:

Circle

p=45,-93&radius=50miles

The circle requires a center point along with a radius.

Rectangle

p=43.23,-96.92,45.62,-91.31

The rectangle geometry requires two points separated by a comma. The first point must be the lower left (SW) coordinate while the second point must be the upper right (NE) coordinate.

Polygon

p=36.89,-106.25,43.89,-106.56,44.82,-92.77,41.02,-87.76,35.06,-92.29

The polygon option must include at least three points separated by commas. Each point represents a corner of the polygon. In the example above there are five points which means the user is passing a pentagon shape requesting data within those points. You do not need to pass a closed polygon.