Skip to content
Navigation

Contour lines from swissSURFACE3D around a point (GeoJSON / DXF / Shapefile), streamed

Proxy for the Contoor 3D API (project_res_3D_api, FastAPI, systemd unit contoor-3d-api on the RES box, published at contoor-api-contabo.gisjoe.com). RES adds the RES token, the request allowlist and RES-hosted artifact URLs so one contract and one credential cover parcels and meshes.

Builds a DEM from the LiDAR points in a square of ± bbox_radius_m (optionally filtered to ground, trees, buildings), extracts contours at interval_m, and streams the file. format=geojson streams GeoJSON (WGS84); dxf and shapefile stream a binary file (Shapefile as a ZIP). Proxy timeout 300 s.

GET
https://res.aireon.ch/res_api/3d/contour

Authorization

  • ResApiToken
    optional
    API key in header
  • ResApiTokenQuery
    optional
    API key in query

Query parameters

  • lat
    number
    required
  • lng
    number
    required
  • format
    optional
    geojson
    or
    dxf
    or
    shapefile
    default: "geojson"
  • bbox_radius_m
    optional
    number
    maximum: 1000 · minimum: 10 · default: 50
  • interval_m
    optional
    number
    maximum: 100 · minimum: 0.1 · default: 1
  • resolution_m
    optional
    number

    DEM grid resolution.

    maximum: 10 · minimum: 0.1 · default: 0.5
  • smooth
    optional
    boolean
    default: true
  • selected_pointcloud_class
    optional
    string

    Comma-separated subset of ground, vegetation, tree, trees, buildings.

  • token
    optional
    string

Returns

200

The contour file.

GEO+JSON
OCTET-STREAM
string

400

Invalid request.
JSON
  • error
    string
    required

    Human-readable error description.

  • message
    optional
    string

    Optional underlying error message.

401

Authentication missing or invalid.
JSON
  • error
    string
    required

    Human-readable error description.

  • message
    optional
    string

    Optional underlying error message.

403

Authenticated but not permitted.
JSON
  • error
    string
    required

    Human-readable error description.

  • message
    optional
    string

    Optional underlying error message.

502

The 3D service is unreachable or answered with an error (its status and body are relayed in upstream_status / upstream).
JSON
  • error
    optional
    string
  • upstream_status
    optional
    integer
  • upstream
    optional
    unknown
  • detail
    optional
    string

504

The 3D service did not answer within the proxy timeout.
JSON
  • error
    optional
    string
  • detail
    optional
    string

Type to search…

↑↓ navigate↵ selectEsc close