Skip to content

WMS

Nexus WMS API service returns pre-rendered rasters in a users' world.

GET wms/?layers={layers}&token={web_api_token}

Parameters

Parameter Mandatory Meaning Default value
layers Yes Name of requested layer, in format {world}:rasterbase -
request No Type of request: getmap, getcapabilities getcapabilities
format Yes Image format, for example image/png or image/jpg -
crs Yes Coordinate reference system, as EPSG code (for example epsg:3857) -
styles Yes Name of styling to apply, for example red_yellow_blue_linear, see styling below -
dim_parameter Yes Name of parameter, for example drought_stress_index_pct -
dim_dc_id Yes Data connection(s) IDs to filter on -
time Yes Raster timestamp, for example 2025-01-13T00:00:00Z -
bbox Yes Geographic bounding box, in format x_ll,y_ll,x_ur,y_ur -
env Yes Colormap stops, for example min:0;max:90;stop1:0;stop2:12;stop3:23;stop4:35 -

Styling

Nexus supports 30 predefined stylings: 5 colormaps times 6 variants. The naming convention is {colormap}_{variant}, for example red_yellow_blue_5_linear.

Colormaps

The existing colormaps are brown_green_blue_5, greens_5, red_yellow_blue_7, red_yellow_blue_5, blue_purple_5.

Variants

A variant controls how colors are applied between stops:

Variant Description
linear Smooth gradient: values between stops are blended proportionally. With env=min:0;max:60;stop0:0;stop1:30;stop2:45, value 0 maps to red, value 30 to yellow, value 45 to blue, with smooth blending in between.
discrete Step function: each range between stops maps to a single flat color. The same env produces three solid bands: 0–30, 30–45, and 45–60.
exact Lookup: only values that exactly match a stop are colored; all other values are transparent.
linear_reversed Same as linear, but with reversed color order.
discrete_reversed Same as discrete, but with reversed color order.
exact_reversed Same as exact, but with reversed color order.