This endpoint supports the following types of searches:

  • boundaries overlapping a point, polygon, multipolygon, feature, a bbox or a boundary/list of boundaries:
    • The point can be expressed as lon/lat, point, geohash, with buffer parameter defining the maximum allowed distance. Spatial search area limit is 25 km2 (also in case of bbox and geometry in input).
    • The boundary/list of boundaries must be specified in the format
      boundary_relationships.boundary_id=<UUID_1>,<UUID_2>
      with
      boundary_relationships.type=overlaps
    • The response can be restricted to just field boundaries by setting
      field_relationships.type=delineates
  • boundaries delineating fields:
    • The list of fields must be specified in the format
      field_relationships.field_id=123A.BCDE,456F.GHIL,...
      field_relationships.type is defaulted to 'delineates'.
      Optionally, the search can be restricted to field boundaries active during a specific period of time by specifying
      field_relationships.effective_from=YYYY-MM-DD
      field_relationships.effective_to=YYYY-MM-DD
      Parameters define a time range:
      - [from, to]: if an interval is specified, output collection will contain boundaries active in that time range
      - [from, ]: the time interval is open ended and will include current date-time
      - [, to]: only boundaries active until specified value are returned
      - [, ]: if no parameters are provided, the only boundary returned in the collection is the current active boundary of the field.

Boundaries are returned as a GeoJSON FeatureCollection. Metadata is always included in response for each boundary, while geometry is provided only if policy allows (i.e., if the geometry is 'shared' or accessible to the tenant performing the search).

Language
Authorization
Bearer
JWT
Click Try It! to start a request and see the response here!