Skip to content

Layer groups

A layer group is a grouping of layers and styles that can be accessed as a single layer in a WMS GetMap request. A layer group is sometimes referred to as a "base map".

/layergroups[.<format>]

Controls all layer groups.
    • Method
    • Action
    • Status code
    • Formats
    • Default Format
    • GET
    • Return all layer groups
    • 200
    • HTML, XML, JSON
    • HTML
    • POST
    • Add a new layer group
    • 201, with Location header
    • XML,JSON
    • PUT
    • 405
    • DELETE
    • 405

/layergroups/<lg>[.<format>]

Controls a particular layer group.
    • Method
    • Action
    • Status code
    • Formats
    • Default Format
    • Parameters
    • POST
    • 405
    • PUT
    • Modify layer group lg
    • 200
    • XML,JSON
    • DELETE
    • Delete layer group lg
    • 200

Exceptions
    • Exception
    • Status code
    • GET for a layer group that does not exist
    • 404
    • POST that specifies layer group with no layers
    • 400
    • PUT that changes name of layer group
    • 403

Parameters

quietOnNotFound

The quietOnNotFound parameter avoids to log an Exception when the layergroup is not present. Note that 404 status code will be returned anyway.

/workspaces/<ws>/layergroups[.<format>]

Controls all layer groups in a given workspace.
    • Method
    • Action
    • Status code
    • Formats
    • Default Format
    • GET
    • Return all layer groups within workspace ws
    • 200
    • HTML, XML, JSON
    • HTML
    • POST
    • Add a new layer group within workspace ws
    • 201, with Location header
    • XML,JSON
    • PUT
    • 405
    • DELETE
    • 405

/workspaces/<ws>/layergroups/<lg>[.<format>]

Controls a particular layer group in a given workspace.
    • Method
    • Action
    • Status code
    • Formats
    • Default Format
    • GET
    • Return layer group lg within workspace ws
    • 200
    • HTML, XML, JSON
    • HTML
    • quietOnNotFound
    • POST
    • 405
    • PUT
    • Modify layer group lg within workspace ws
    • 200
    • XML,JSON
    • DELETE
    • Delete layer group lg within workspace ws
    • 200

Exceptions
    • Exception
    • Status code
    • GET for a layer group that does not exist for that workspace
    • 404