Area

Area Geometry Search

Changed on

Search for parcels in a specific geographical area. This endpoint allows access to test all our premium matched datasets with applicable API token. Accepted formats vary from GeoJSON Feature Collection of geometries (Polygon, MultiPolygon, Point, MultiPoint, LineString and/or MultiLineString), or a Feature with a GeoJSON geometry or a direct GeoJSON geometry. These parameters also accept an optional radius parameter in meters to create a buffer around the given geometries. Note adding a radius can increase the overall area of the request reaching the area size limit per request.

post/parcels/area

Request

  • Base URL
    https://app.regrid.com/api/v2
  • URL
    https://app.regrid.com/api/v2/parcels/area
  • Auth
    • API key in header x-regrid-token
    • or API key in query parameter token

Query parameters

radiusinteger

(Default: 0, Maximum: 32000) Radius in meters for which all Parcel records will be returned if they are within the radius zone from latitude and longitude point.

offset_idinteger

ID from a previous query exceeding the limit, returns the next set of results up to limit.

limitinteger

Maximum number of Parcel Records to return.

return_geometryboolean

Default true. A features are returned without geometry values.

return_countboolean

Set to true to enable count of parcels in query.

return_customboolean

Default false: A true value allows county-specific fields to be passed through beyond standard schema fields only.

return_field_labelsboolean

Default false: A true value shows the naming convention for each standardized schema field.

return_stackedboolean

Default true: A false value returns the first parcel if geometries are identical.

return_zoningboolean

Set to false to disable zoning data in the response. Default is true when supported by the account.

return_matched_buildingsboolean

Set to false to disable building footprint data in the response. Default is true when supported by the account.

return_matched_addressesboolean

Set to false to matched addresses data in the response. Default is true when supported by the account.

return_enhanced_ownershipboolean

Set to false to disable enhanced ownership data in the response. Default is true when supported by the account.

return_custom_idboolean

Default false. Set to true when input GeoJSON features include a 'custom_id' field in the 'properties' object. This flag enables the resulting parcels to include the user-set custom ID for matching parcel(s).

return_parcelsboolean

Default true. A false value will not return parcel records. Used to return additional add-on datasets when parcel information is not needed.

Request body

Example request

{
  "geojson": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -96.77737790638413,
          32.8277929786983
        ],
        [
          -96.77476147447638,
          32.82780540015257
        ],
        [
          -96.77614360093615,
          32.82905995805102
        ]
      ]
    ]
  }
}

Response

A list of parcel features. When supported by the account with buildings array and addresses property

OR

Example response

{
  "parcels": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "score": 86.75966
        }
      }
    ]
  },
  "buildings": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature"
      }
    ]
  },
  "zoning": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature"
      }
    ]
  }
}

Changes

    • breaking

      for the query request parameter return_custom, default value false was removed

    • breaking

      for the query request parameter return_field_labels, default value false was removed

    • breaking

      for the query request parameter return_geometry, default value true was removed

    • breaking

      for the query request parameter return_stacked, default value true was removed

    • info

      added the new optional query request parameter return_custom_id

    • info

      added the new optional query request parameter return_parcels