Skip to content
Navigation

Get parcel data by coordinate or EGRID

Returns full parcel data for a Swiss parcel, located either by WGS84 coordinate (lat/lng) or by parcel egrid.

With structure: "default" the response is the raw GeoServer GeoJSON FeatureCollection, enriched with owner, isSignal, image_urls and OEREB_url on the first feature's properties. With structure: "tree" the response is a grouped, human-readable object.

POST
https://res.aireon.ch/res_api/parcel_data

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.

  • structure
    optional
    default
    or
    tree

    default returns the raw GeoJSON FeatureCollection; tree returns a grouped, human-readable object.

    default: "default"

Example requests

{
  "lat": 47.3769,
  "lng": 8.5417,
  "structure": "tree"
}

Returns

200

Parcel data. Shape depends on the structure field. Note: a missing/invalid token or missing location produces a plain-text 200 body (see description).

JSON

One of the following:

  • GeoJSONFeatureCollection
    • 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).

  • ParcelTree
    • name
      optional
      string
    • description
      optional
      string
    • owner
      optional
      array of
      object
    • site_score
      optional
      number | null
    • res_id
      optional
      string | number | null
    • uuid
      optional
      string

      UUIDv5 derived from the parcel EGRID.

    • score
      optional
      object
      • score_drive
        optional
        number | null
      • score_walk
        optional
        number | null
      • score_bike
        optional
        number | null
    • address
      optional
      object
      • street
        optional
        string | null
      • city
        optional
        string | null
      • canton
        optional
        string | null
      • zip
        optional
        string | number | null
      • parcel_id
        optional
        string
      • coordinates
        optional
        object
        • x
          optional
          number

          Web Mercator (EPSG:3857) X.

        • y
          optional
          number

          Web Mercator (EPSG:3857) Y.

        • x_2056
          optional
          number

          LV95 (EPSG:2056) X.

        • y_2056
          optional
          number

          LV95 (EPSG:2056) Y.

        • lat
          optional
          number

          WGS84 latitude.

        • lng
          optional
          number

          WGS84 longitude.

    • building
      optional
      object

      Building attributes (construction year, flats, floors, size, volume, heights).

    • plot
      optional
      object

      Plot attributes (area, ratios, GFA, max footprint/volume).

    • construction_zone
      optional
      object

      Construction-zone attributes.

    • noise
      optional
      object

      Rail and street noise levels (day/night, min/mean/max).

    • travel
      optional
      object

      Travel times to the nearest agglomeration.

    • vacancies
      optional
      object

      District vacancy figures.

    • tax
      optional
      object

      Tax attributes.

    • image_urls
      optional
      object
      • parcel_image
        optional
        string
        format: uri
      • satellite_image
        optional
        string
        format: uri
      • world_topo_image
        optional
        string
        format: uri
    • OEREB_url
      optional
      string

      OEREB extract URL, or not available.

HTML
Missing Token

401

Authentication missing or invalid.
JSON
  • error
    string
    required

    Human-readable error description.

  • message
    optional
    string

    Optional underlying error message.

Type to search…

↑↓ navigate↵ selectEsc close