请求参数

GetLegendGraphic 操作的主要请求参数如下表所示：

表1 GetLegendGraphic 操作请求主要参数

请求参数

是否必需

描述

VERSION=version

是

请求版本号。

REQUEST=GetLegendGraphic

是

请求名称。

请求 GetLegendGraphic 操作，请求名称需要设为“GetLegendGraphic”。

LAYER=layer

是

生成图例的图层。图层名称是服务元数据中定义的<Layer><Name>的元素值。

STYLE=style

否

生成图例的的图层样式。未指定时为默认样式。

SLD

否

用于指定描述图层样式的 SLD 文档。使用方式参见使用 SLD

SLD_BODY

否

用于在请求中直接包含描述图层样式的 SLD 信息。使用方式参见使用 SLD

WIDTH=output_width

否

图例图片的像素宽度，默认为16

HEIGHT=output_height

否

图例图片的像素高度，默认为16

FORMAT=output_format

是

图例的输出格式，支持application/json、image/png。

请注意：当选择使用 png 作为输出格式时，仅支持返回单图层图例，图层组或专题图中的图例子项将不会返回。

EXCEPTIONS=exception_format

否

同 GetMap。WMS 的异常错误报告格式（默认为 application/vnd.ogc.se_xml）。

请求示例

GetLegendGraphic 操作的请求方式如下：

<ServiceRoot>?VERSION=version&REQUEST=GetLegendGraphic& LAYER=layer&FORMAT=output_format&STYLE=&SLD=&WIDTH=&HEIGHT=&EXCEPTIONS=

ServiceRoot 为服务的 URI 根目录，请参见 服务的 URI 设置。

例如，本机 SuperMap iServer WMS 1.1.1 服务启动成功之后，访问 GetLegendGraphic 操作的 URI 是：http://localhost:8090/iserver/services/map-China/wms111/China?VERSION=1.1.1&REQUEST=GetLegendGraphic&LAYER=0.2&WIDTH=80&HEIGHT=80&FORMAT=application/json。

该请求示例的响应结果请参见 响应示例。