symbolMarker

URI

<symbols_uri>/marker/items/{markerID}[.<format>]

支持的方法

GET、HEAD

父资源

3D、symbols

介绍

二维点符号资源，表示一个具体的二维点符号。

支持的方法：

GET：获取一个具体的二维点符号。
HEAD：检查 symbolMarker 资源是否存在，或权限是否可以访问 symbolMarker 资源。

支持的表述格式：symbolMarker 资源返回的是一个具体的二维点符号图片，其格式可以为 png、jpg、bmp、gif、jpeg。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/symbols/marker/items/{markerID}

GET 请求

获取一个具体的二维点符号。

请求参数

获取二维点符号需要传递相应的参数，“?”之前传递的参数如下：

名称	类型	含义
markerID	int	二维点符号的 ID【必选参数】

“?”之后传递的参数（可选参数）如下：

字段	类型	说明
height	int	图片高度像素值，默认为64。
width	int	图片宽度像素值，默认为64。
transparent	boolean	是否透明，默认为 false。
foreColor	color	点符号的前景色，当请求的二维点符号为矢量符号时，可以设置此参数。

响应示例

对 ID 为1110的二维点符号资源执行 get 请求，设置宽度高度均设置为128，前景色为红色请求的 URI 为：

http://localhost:8090/iserver/services/realspace-RealspaceSymbols/rest/realspace/symbols/marker/items/1110?width=126&height=126&foreColor={"red":255,"green":0,"blue":0}

则返回的二维点符号如下所示：

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 symbolMarker 资源是否存在，或者客户端是否有权限访问 symbolMarker 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 symbolMarker 资源是否支持<format>格式的表述。

URI