WMS-ChartServer API
WMS-ChartServer API
Version 5.0
Copyright:
All rights reserved. No part of this document may be reproduced, in any form or by any means,
disclosed or used by any person who has not received prior written authorization from SevenCs
GmbH.
Brand names:
Brand names, logos and trademarks used in this document remain the property of their respective
owners.
Referrals and links:
SevenCs does not assume any liability for any external content linked to our site / to this document,
including links provided in our website. SevenCs has no influence on the content of such sites. The
owners of such linked websites take sole responsibility for their content.
Disclaimer:
SevenCs does not guarantee the up-to-date nature, correctness, completeness or quality of the
information provided. Claims of liability referring to material damages or damages pertaining to
ideas, due to the use or non-use of the information or due to the use of wrong and/or incomplete
information, are strictly ruled out, as long as there is no verifiable wilful or reckless fault on the part
of SevenCs GmbH.
ChartWorld WMS - API
Preface
This document is aimed at users who are going to integrate ChartWorld Web Map Service (WMS)
into their operations. It gives an overview of the API, i.e. the standard WMS parameters, the
proprietary parameters, and the extended capabilities.
Document Conventions
This manual uses several conventions to highlight certain words and phrases and draw attention to
specific pieces of information.
Calibri bold italic font is used for file names or environment variables
Note:
Such a note box displays important information which should not be ignored.
#Configuration file
Version 1.0
screenW 1024
screenH 768
1.1 GetCapabilities
1.2 GetMap
Optional parameters:
1.3 GetFeatureInfo
Example:
https://wms.sevencs.com/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetFeatureInfo&LAYERS=
ENC&QUERY_LAYERS=ENC&CRS=EPSG:3857&I=100&J=100&WIDTH=1400&HEIGHT=800&BBOX=-
8251945,4917810,-8197293,4950105&INFO_FORMAT=text/xml
Example output:
<?xml version="1.0" encoding="UTF-8"?>
<PicReport i="100" j="100" lat="40.54905" lon="-74.09327">
<Feature Name="Depth Area" Cell="US4NY1AM.000" Token="DEPARE" GeoType="Area"
Type="Geo">
<Attribute Name="Depth range value 1 (shoalest value)" Value="0"
Token="DRVAL1"/>
<Attribute Name="Depth range value 2 (deepest value)" Value="1.8"
Token="DRVAL2"/>
</Feature>
<Feature Name="Navigation Line" Cell="US4NY1AM.000" Token="NAVLNE" GeoType="Line"
Type="Geo">
<Attribute Name="Category of Navigation Line" Value="3" Token="CATNAV"
ValueName="leading line bearing a recommended track"/>
<Attribute Name="Orientation" Value="305" Token="ORIENT"/>
<Attribute Name="Scale minimum" Value="179999" Token="SCAMIN"/>
<Attribute Name="Source date" Value="20120508" Token="SORDAT"/>
<Attribute Name="Source indication" Value="US,US,reprt,1stCGD,LNM 19/12"
Token="SORIND"/>
</Feature>
</PicReport>
Chart settings depending on values can be defined by means of the CSVALUE parameter.
No. 1 2 3 4 5 6 7 8 9 10 11
Safety Shallow Deep Safety Symbol Display Color Text Shallow Deep Layer
Contour Contour Contour Depth Set Category Scheme Scale Sounding Sounding Strategy
Scale Scale
Type value value value value enum enum enum value value value enum
The three scale values define the scale at which the respective chart objects will be displayed. For
instance, the value 1,000,000 for Text means that text is only displayed at scales larger than
1:1,000,000, i.e. the user has to zoom in on a greater scale than this.
The layer strategy defines how layers are handled if more than one layer is defined
Examples: CSVALUE=10,5,20,10,1,2,1,500000,100000,200000,1 will set all values
CSVALUE=,,,,,3 will set only the display category; all other values are default
Safety Contour
Shallow Contour
Deep Contour
Safety Depth Defines the limit of shallow soundings (black) and deep soundings (grey)
Symbol Set Simplified or traditional (paper chart) symbolization of buoys, beacons and
navigational-area boundaries
Display Category S-52 Display Category: Base, Standard or Other (Base = minimum, other = all
chart objects)
Color Scheme S-52 Colour Scheme (Day, Dusk or Night)
Text Scale Minimum scale values for text, shallow soundings, and deep soundings
Sounding Scale
The display of the following chart objects can be switched on and off by means of the parameter
CSBOOL.
No Setting Description
1 Lights Light flare and light sectors
2 Text Chart-object names, e.g. of cities, land regions, sea areas,
navigational aids
3 Symbol fail Indication of ‘symbol fails’ (a case of a symbol failing), i.e.
missing information for use of symbols
4 Shallow Pattern Shallow waters will be indicated by a special pattern
5 Overscale Indication (straight-line pattern) if display scale is bigger
than chart-compilation scale
6 Info Points Indication (magenta ‘i’) of chart objects which contain
additional information
7 Grid Chart Grid (only supported for rectangular chart
projections)
8 Shallow Spot soundings shallower than the defined safety depth
Soundings
9 Deep Soundings Spot soundings deeper than the defined safety depth
10 Two Shades Depth areas will only be displayed by two colours, i.e. dark
blue (unsafe) and white (safe)
11 Grey Shades The entire chart image will be converted to grey shades
12 Chart SCAMIN SCAMIN of the chart objects will be taken into account
13 Auto SCAMIN SCAMIN will be applied automatically
14 Chart Chart boundaries of charts loaded (grey lines) and available
boundaries: charts of better usage or bigger scale (magenta lines)
15 Contour Labels Labels of depth contours (Display category has to be set to
‘All’, to display depth contours)
16 National Text Chart-object names encoded with non-Latin- alphabet
characters will be displayed
Example CSBOOL=4183:
Show Lights (1) + ShowText (2) + Show Shallow Soundings (8) + Show Deep Soundings (9) + Show
Contour Labels (15)
No 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1
Pow 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Bin 0 1 0 0 0 0 0 1 1 0 0 0 0 0 1 1
Dec 214 28 27 26 21 20
Dec 32768 16384 8192 4096 2048 1024 512 256 128 64 32 16 8 4 2 1
Hex 8000 4000 2000 1000 800 400 200 100 80 40 20 10 8 4 2 1
Hex 4183
Note:
Trying to make a switchover between ‘show text’, ‘show shallow soundings’ and ‘show deep
soundings’ may have no effect; what decides this is the defined scale, i.e. the 8th, 9th or 10th value
of the CSVALUE parameter. The S-52 display category (6th CSVALUE) has a higher order than the
CSBOOL values. For instance, soundings will not be shown if the display category is not ‘ALL’.
Example:
https://wms.sevencs.com/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&C
RS=EPSG:3857&CSBOOL=4183&WIDTH=1400&HEIGHT=800&BBOX=-8251945,4917810,-
8197293,4950105&FORMAT=image/png
The parameters OBJECT and OBJECTGROUP can be used in order to only show certain objects
within a chart. With regard to the parameter OBJECT, the objects are defined as a comma-
separated list of the object tokens in the request string. A list of the ENC object tokens can be found
in the Annex
Examples: OBJECT=SOUNDG will only draw soundings
Note:
The filter is applied to all charts loaded. If a large-scale, more detailed and accurate chart is drawn
on top of a small scale chart, the objects of both charts will be drawn. This may lead to multiple
symbols or lines, if the filled areas of the large-scale chart covering the smaller-scale chart are not
drawn.
The use of the filter does not disable the display settings, e.g. display category or SCAMIN.
Therefore, it is advised to switch to display category ‘Other’ when using the filter.
If all objects must be displayed, except some defined objects, the parameter
OBJECTFILTERNEGATION can be used. In that case, all objects are displayed, except the ones
defined using the parameter OBJECT (and, if also used, OBJECTGROUP).
Example: OBJECT=LNDARE,M_COVR&OBJECTFILTERNEGATION=TRUE will display all objects
except land areas and chart boundaries, e.g. to overlay a satellite image.
https://wms.sevencs.com/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&C
RS=EPSG:3857&OBJECT=LNDARE,M_COVR&OBJECTFILTERNEGATION=TRUE&WIDTH=1400&HEIG
HT=800&BBOX=-8251945,4917810,-8197293,4950105&FORMAT=image/png
Buildings
Railway Road
Navigational line/recommended
Ferry route
track
Navigational line
Recommended track
(as transit, clearing line)
Offshore
Pipeline
Areas, Boundaries
Restricted area
Restricted area (fishing prohibited)
(anchoring prohibited)
Constructions, Ports
Pontoon River/canal
Landmarks
Production area
Refinery area
(timber yard)
Silo, tank
Radar scanner Silo, tank
(silo in general)
Fortified structure
Dish aerial Dome
(castle, fort)
Production area
Wind motor Windmill
(wind farm)
Flagstaff
Sloping ground
(flagpole)
Obstructions
Underwater rock (always Underwater rock Underwater rock
under water) (awash) (covers and uncovers)
Underwater rock as
Underwater rock of isolated danger (if
Obstruction
known depth shallower than safety
contour)
Obstruction Obstruction Obstruction of known
(foul ground) (always dry) depth
Obstruction as isolated
Non-dangerous wreck
danger (if shallower than Dangerous wreck
(always under water)
safety contour)
Wreck showing any
Wreck of known depth
Wreck of known depth portion of hull or
(swept by wire drag)
superstructure
Wreck as isolated danger
(if shallower than safety contour)
Point Symbols A
Point Symbols B
Radar transponder
Berth (with name) Pilot boarding place
beacon
Navigational Aids
Direction of Buoyage
Mooring Buoys
1 2 3 4 5 6 7 8 9 10
Beacons (1 - 3) and Buoys (4 - 10): colour: unknown
1: Shape: stake pole
2: Shape: lattice beacon
3: Shape: beacon tower
4: Shape: spar (spindle)
5: Shape: can (cylindrical)
6: Shape: conical
7: Shape: pillar
8: Shape: spherical
1 2 3 4 5 6
East cardinal marks (4, 5, 6: lighted marks):
Colour: black, yellow, black
Topmark: two cones, base to base
Lights: white
1 2 3 4 5 6
North cardinal marks (4, 5, 6: lighted marks):
Colour: black, yellow
Topmark: two cones, points upward
Lights: white
1 2 3 4 5 6
South cardinal marks (4, 5, 6: lighted marks):
Colour: yellow, black
Topmark: two cones, points downward
Lights: white
1 2 3 4 5 6
West cardinal marks (4, 5, 6: lighted marks):
Colour: yellow, black, yellow
Topmark: two cones, point to point
Lights: white
1 2 3 4 5 6
Isolated danger marks (4, 5, 6: lighted marks):
Colour: black, red, black
Topmark: two black spheres
Lights: white
1 2 3 4 5 6 7 8 9 10
Starboard-hand lateral marks (5, 6, 10: with topmark, 6, 7, 8: lighted, 9: starboard-hand withy):
Colour: green
Topmark: 5, 6: cone point up, 10: besom point up
Lights: green
1 2 3 4 5 6 7 8 9 10
Port-hand lateral marks (5, 6, 10: with topmark, 6, 7, 8: lighted, 9: port-hand withy):
Colour: red
Topmark: 5, 6: cylinder (can)
10: besom point down
1 2 3 4 5 6 7 8
Preferred channel to starboard (5, 6: with topmark, 6, 7, 8: lighted):
Colour: red, green, red
Topmark: cylinder (can)
Lights: red
1 2 3 4 5 6 7 8
Preferred channel to port (5, 6: with topmark, 6, 7, 8: lighted):
Colour: green, red, green
Topmark: cone point up
Lights: green
Safe-Water Marks
1 2 3 4 5 6
Safe-water marks (5, 6, 7: lighted marks):
Colour: red, white
Topmark: red sphere
Lights: white
Special-Purpose Marks
1 2 3 4 5 6 7 8 9
Special-purpose marks (7, 8, 9: lighted and with topmark):
Colour: yellow
Topmark: yellow x-shaped cross
Lights: yellow
Lights Symbols
1 2 3 4
Carried by a landmark or non floating object:
1 Colour unknown
2 Colour red
3 Colour green
4 Colour yellow or white
_________________________________________________________________
1 2 3 4
Carried by a floating object or if used as leading light:
1 Colour unknown
2 Colour red
3 Colour green
4 Colour yellow or white
_________________________________________________________________
1 2 3 4 5
1 Strip light
2 Spotlight
3 Floodlight
4 Light-float
5 Light-vessel
__________________________________________________________________
Sector lights
__________________________________________________________________
Leading lights