Spatial Queries

Radius and bounding box spatial queries for finding parcels by location.

Overview

The API supports two types of spatial queries: radius search (point + distance) and bounding box search (rectangular area). Both are available on the /v1/parcels/search endpoint.

Radius Search

Find all parcels within a given distance of a point:

Code

curl "https://api.aribatax.com/v1/parcels/search?lat=39.7684&lng=-86.1581&radius_mi=0.5" \
  -H "X-API-Key: your_api_key_here"

| Parameter | Type | Description | |-----------|------|-------------| | lat | number | Latitude of the center point | | lng | number | Longitude of the center point | | radius_mi | number | Search radius in miles (max 10) |

Results are ordered by distance from the center point, nearest first.

Bounding Box Search

Find all parcels within a rectangular geographic area:

Code

curl "https://api.aribatax.com/v1/parcels/search?bbox=-86.2,39.7,-86.1,39.8" \
  -H "X-API-Key: your_api_key_here"

The bbox parameter takes four comma-separated values: west,south,east,north (min longitude, min latitude, max longitude, max latitude).

Combining Spatial with Other Filters

Spatial queries can be combined with all other search filters:

Code

curl "https://api.aribatax.com/v1/parcels/search?lat=39.7684&lng=-86.1581&radius_mi=1&property_class=commercial&min_av=500000" \
  -H "X-API-Key: your_api_key_here"

This finds commercial properties valued over $500,000 within 1 mile of downtown Indianapolis.

Response with Distance

When using radius search, each result includes a distance_mi field:

Code

{
  "data": [
    {
      "state_parcel_id": "180490110004000015",
      "address": { "street": "4521 N Meridian St" },
      "distance_mi": 0.12,
      "total_av": 243000
    }
  ],
  "meta": {
    "total": 156,
    "limit": 20,
    "offset": 0
  }
}

Performance Notes

Radius searches up to 1 mile typically return in under 200ms
Larger radii (5-10 miles) may return thousands of results; use limit and offset to paginate
Bounding box queries are most efficient when the box is small (a few city blocks)
Both query types use spatial indexes and perform well even over the full 3.7 million parcel dataset