GIServer - Vectorial Specific Request Parameters

Original File	vecparam.htm
Abstract	This web page sumarizes the GIServer parameters created to enhace the interactivity with the Web Map Server for Vectorial Data
Author	Pedro Pereira Gonçalves (email)
Last Change
History	2002-03-04 : Query parameters moved to vecquery.htm 2001-11-27 : Parameters added 2001-10-18 : File Created
Index Page	GIServer tutorial
Important Links:

Apart from WMS parameters, the GIServer accepts layer-specific parameters. These parameters enhance the interactivity of the requests and give a direct linkage to the GIS data.
When requesting these parameters it is necessary to specify to which layer are they refering. For example, if the request is to drawn a borders layer with a PEN width of 2 pixels, it is necessary to specify :

<dataset>.<layer>.PEN = 2

Even if the GIServer parameters do NOT respect the WMS specification, all these non-WMS conformant parameters might be transformed in to style definition (see Styles and GIServer Parameters) For vectorial data the following parameters are defined:

.field
This parameter is defines the associated database field to be used when accessing vectorial data. It can be a integer (defining the field number) or a string (defining the field's name).

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME
.pen
Defines the width (in pixels) of the pen that draw the lines and points of vectorial files.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.PEN=2
.pencolor
Defines the color of the pen that draws the lines and points of vectorial files. It must be express in the Hex format, where for example 0xFFFFFF is white, 0x000000 is black, 0xFF0000 is red, 0x00FF00 is green and 0x0000FF is blue.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.PENCOLOR=0x630000
.color
Defines the color of the brush that will fill the polygons of vectorial files. It must be express in the Hex format, where for example 0xFFFFFF is white, 0x000000 is black, 0xFF0000 is red, 0x00FF00 is green and 0x0000FF is blue.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.COLOR=0x630000
.penstyle
This integer parameter defines pen style to be used to draw the lines.Possible values are: iPSSolid = 0; iPSDash = 1; iPSDot = 2; iPSDashDot = 3; iPSDashDotDot = 4; iPSNull = 5; iPSInsedeFrame = 6;

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.PENSTYLE=5
.brush
This integer parameter defines the pattern of the brush to be used to paint polygons. Possible values are: iBSSolid = 0; iBSClear = 1; iBSBDiagonal = 2; iBSFDiagonal = 3; iBSCross = 4; iBSDiagCross = 5; iBSHorizontal = 6; iBSVertical = 7;

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.COLOR=0x630000&
TERRA.BORDERS.BRUSH=4
.pal (also available for raster data)
This integer parameter defines the palette to be used. Check out the possible values at the inovaGIS help files.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.PAL=4

As in inovaGIS objects you can defined your own automatic palette by requesting the pal as :
AUTO(StartingColor,EndingColor,NumberOfColors)
Example : AUTO(0x630000,0xFFFFFF,250)
.drawlabels
This boolean parameter informs the server to paint the text of the selected field.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-20,35,10,50&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.LABELSIZE=10&
TERRA.BORDERS.DRAWLABELS=TRUE
.labelfont
This string parameter informs the server to draw the text data in the requested font.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-20,35,10,50&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.DRAWLABELS=TRUE&
TERRA.BORDERS.LABELFONT=VERDANA
.labelsize
This integer parameter informs the server to draw the text data in the requested size. If the value is > 0 the font mapper transforms this value into device units and matches it against the cell height of the available fonts. If it is equal to zero the font mapper uses a default height value when it searches for a match. And if it is < 0 The font mapper transforms this value into device units and matches its absolute value against the character height of the available fonts.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-20,35,10,50&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.DRAWLABELS=TRUE&
TERRA.BORDERS.LABELSIZE=-6
.labelstyle
This string parameter informs the server to draw the text data in the requested font. Possible values are: THIN, REGULAR, SEMIBOLD, BOLD, ULTRABOLD, HEAVY, UNDERLINE, ITALIC, STRIKEOUT. It can be defined as a string like 'REGULARitalicUnderline' because it is not case sensitive and the order of parameters is not important.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-20,35,10,50&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.DRAWLABELS=TRUE&
TERRA.BORDERS.LABELSTYLE=REGULARitalicUnderline
.labelcolor
This string parameter defines the color of font that will draw the text data. It must be express in the Hex format, where for example 0xFFFFFF is white, 0x000000 is black, 0xFF0000 is red, 0x00FF00 is green and 0x0000FF is blue.

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-20,35,10,50&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.DRAWLABELS=TRUE&
TERRA.BORDERS.LABELCOLOR=0x630000

See also: