Get a parcel and its neighbouring parcels

Returns the raw GeoServer GeoJSON FeatureCollection for a parcel located by lat/lng or egrid (currently the same query as /res_api/parcel_data; a bounding-box neighbour filter is planned).

POST

https://res.aireon.ch/res_api/parcel_data_neighbor

Authorization

ResApiToken
API key in header
required

Request body JSON required

lat
optional
number
WGS84 latitude.
lng
optional
number
WGS84 longitude.
egrid
optional
string
Parcel EGRID identifier.

Returns

200

GeoJSON FeatureCollection, or a plain-text error body.

JSON

type
optional
string
features
optional
array of
object
- type
  optional
  string
- id
  optional
  string
- geometry
  optional
  object
- properties
  optional
  object
  Open property bag. /res_api/parcel_data adds the following room-app density fields on the first feature.
  
  ratio_v
  optional
  number | null
  Built volume relative to the zone reference volume (percent; 100 = typical for the zone), i.e. cz_util_now divided by the zone 20-year median utilization x 100. It is not utilization and not a share of a legal allowance. Existing value from the parcel table is passed through unchanged; computed as bldg_vol_sb3dgdb / vol_max * 100 when absent (vol_max is the zone reference volume).
  
  free_v
  optional
  number | null
  vol_max - bldg_vol_sb3dgdb, in m³: the zone reference volume minus the built volume. Negative when the parcel is built above the zone reference; not a legal allowance.
  
  ratio_s
  optional
  number | null
  Built-footprint / parcel_area (percent). Passed through from the parcel table when populated.
  
  gfz
  optional
  number | null
  Geschossflächenziffer - gfa_now / parcel_area.
  
  bldg_height_m
  optional
  number | null
  Tallest building on the parcel, in metres (= bldg_height_max).
  
  bldg_floors_n
  optional
  number | null
  Max number of floors on the parcel (= bldg_floors).
}

HTML

Missing Token

401

Authentication missing or invalid.

JSON

error
string
required
Human-readable error description.
message
optional
string
Optional underlying error message.

curl --request POST \ --url https://res.aireon.ch/res_api/parcel_data_neighbor \ --header 'Content-Type: application/json' \ --header 'token: <token>' \ --data ' { "lat": 0, "lng": 0, "egrid": "string" } '

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "id": "string", "geometry": {}, "properties": { "ratio_v": 0, "free_v": 0, "ratio_s": 0, "gfz": 0, "bldg_height_m": 0, "bldg_floors_n": 0 } } ] }