Clipped swissSURFACE3D point cloud as GeoJSON points

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.

Clips the swissSURFACE3D LiDAR tile(s) to a square of ± bbox_radius_m around the point, optionally filtered by LAS class, and returns the points as a GeoJSON FeatureCollection (WGS84 point features with elevation and class/height colour attributes). Large radii produce very large answers - start with 30–50 m. Proxy timeout 180 s (a first request for a tile downloads ~180 MB upstream).

POST

https://res.aireon.ch/res_api/3d/pointcloud

Authorization

ResApiToken
API key in header
required

Request body JSON required

lat
number
required
WGS84 latitude (inside Switzerland).
lng
number
required
WGS84 longitude (inside Switzerland).
bbox_radius_m
optional
number
maximum: 1000 · minimum: 10 · default: 50
selected_classes
optional
array of
ground
or
vegetation
or
tree
or
trees
or
buildings
LAS classes to keep; omit for all points.
color_by
optional
class
or
height
default: "class"

Returns

200

GeoJSON FeatureCollection of points.

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

curl --request POST \ --url https://res.aireon.ch/res_api/3d/pointcloud \ --header 'Content-Type: application/json' \ --header 'token: <token>' \ --data ' { "lat": 47.640269, "lng": 9.193094, "bbox_radius_m": 30, "selected_classes": [ "buildings" ] } '