Render a parcel image (PNG) - JSON body variant

Renders a styled PNG of the parcel from the GeoServer WMS. Location is given by lat/lng or by x_3857/y_3857 (Web Mercator).

POST

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

Authorization

ResApiToken
API key in header
required

Request body JSON required

lat
optional
number
WGS84 latitude.
lng
optional
number
WGS84 longitude.
x_3857
optional
number
Web Mercator X coordinate.
y_3857
optional
number
Web Mercator Y coordinate.
img_size
optional
integer
Output image width/height, in pixels.

default: 512
bounding_dist
optional
number
Half-extent of the rendered bounding box, in metres.

default: 200
style
optional
ratio_v_free
or
score
or
red
or
green
Render style.

default: "ratio_v_free"

Returns

200

PNG image, or a plain-text error body.

HTML

PNG

string

401

Authentication missing or invalid.

JSON

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

500

Internal failure while building the WMS request. Plain text, Cache-Control: no-store.

502

GeoServer WMS unreachable, or it answered a non-2xx status or a non-image body (a WMS ServiceException). Plain text, Cache-Control: no-store.

curl --request POST \ --url https://res.aireon.ch/res_api/parcel_image \ --header 'Content-Type: application/json' \ --header 'token: <token>' \ --data ' { "lat": 0, "lng": 0, "x_3857": 0, "y_3857": 0, "img_size": 512, "bounding_dist": 200, "style": "ratio_v_free" } '