vectorSymbols


URI

<tileFeature_uri>/**[.<format>]

Supported methods

GET, HEAD

Parent resource

 tileFeature

Child resources

vectorSymbol

Introduction

The vectorSymbols resource represents the map symbol. It can be a point symbol, a line symbol, a fill symbol, getting the corresponding symbol image by executing a GET request on a URI with parameters.

Supported Methods:

Supported expressions: PNG, BMP, GIF, JPG, RJSON, JSON, HTML, XML.

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with png being the output format.

http://supermapiserver:8090/iserver/services/map-china400/rest/maps/China/tileFeature/symbols.png

GET request

Acquires a symbol image.

Request parameter

Execute a GET request on a vectorSymbols resource, get a symbolic image that needs to contain the relevant parameters in the URI, as follows:

Name Type Description
symbolname String 【One of the two parameters-this one and resourceParameter should be input】
Symbol name.
resourceParameter ResourceParameter 【One of the two parameters-this one and symbolname should be input】
 Symbol picture parameters such as the height, width, type, type of resource, style, etc.
layerName String The layer name the symbol is in.
points Point2D[] Specify the set of ordered points for the geometric object's drawing position. Only valid when the resourceParameter parameter is input.

When drawing point symbols, they will be drawn on all coordinates points; when drawing line symbols, the coordinates points will be the control points to specify the line symbols position, and the coordinates points must contain two or above points; when drawing fill symbols, the coordinates points will consist of a closed area which is filled by the fill symbol, and the coordinates points must contain 3 non-collinear points or above.

 

Response example 1

Execute a GET request on the vectorSymbols resource, specify the symbol by the symbol name:

http://sueprmapiserver:8090/iserver/services/map-china400/rest/maps/China/tileFeature/symbols.png?symbolname=SYMBOLMARKER__China_Capital_pt@China__64__64__true__12081270

The point symbol is returned as follows:

Response example 2

Request a GET request on the vectorSymbols resource to get the symbol image by specifying the image parameters:

http://supermapiserver:8090/iserver/services/map-china400/rest/maps/China/tileFeature/symbols.png?symbolname=&resourceParameter={"outputOption":{"pdfOption":{"regionStyleRetained":false,"entire":false,"vector":false,"lineStyleRetained":false,"pointStyleRetained":false},"foreColor":null,"format":"PNG","transparent":true,"backColor":{"red":255,"blue":255,"green":255,"alpha":255}},"height":64,"style":{"fillBackOpaque":true,"lineWidth":0.1,"fillBackColor":{"red":255,"blue":255,"green":255,"alpha":255},"markerWidth":0,"markerAngle":0,"fillForeColor":{"red":13,"blue":143,"green":80,"alpha":255},"markerSize":2,"fillGradientOffsetRatioX":0,"fillGradientOffsetRatioY":0,"lineColor":{"red":95,"blue":117,"green":118,"alpha":255},"fillOpaqueRate":100,"markerHeight":0,"fillGradientMode":"NONE","fillSymbolID":0,"fillGradientAngle":0,"markerSymbolID":70,"lineSymbolID":0},"width":64,"type":"SYMBOLFILL","mapName":"China"}&layerName=&points=

The fill symbol is returned as follows:

HEAD request

Returns the same HTTP response header as the GET request, but does not have the response entity. It can get the metadata information in the response header without transferring the whole response content. Metadata information includes media type, character encoding, compression encoding, entity content length, and so on.

The HEAD request can be used to determine whether the vectorSymbols resource exists or whether the client has authority to access the resource. It can quickly determine whether the vectorSymbols resource supports the representation in <format> format by performing HEAD request on URI with <format>.

See