GetLegendGraphic¶

什么是栅格图例¶

下面我画了一个典型的图例的结构，其中一些感兴趣的元素是参数化的。

以本页附带的SLD文件之一为例，上表中的每一行都从colormapentry元素中提取其精华，如下所示：

<ColorMapEntry color="#732600" quantity="9888" opacity="1.0" label="<-70 mm"/>

栅格图例的制作者将使用这些元素来构建图例，请注意：

• 颜色元素的宽度由GetLegendGraphic请求的请求宽度驱动。

• 标签和规则的宽度和高度根据所用的字体和字体大小进行计算。（ 目前没有新线管理 ）

• 颜色元素的高度由GetLegendgraphic请求的宽度决定，但请注意，对于渐变，我们稍微扩展了一点，因为目标是将各种颜色元素转换为单个长条带。

• 每行的高度设置为单个元素的最大高度

• 每行的宽度设置为不同元素的宽度加上各种填充的总和。

• Dx和Dy 元素和行之间的间距被设置为请求宽度和高度的15%。注意到 dy 对于类型的颜色映射忽略 ramp 因为它们必须创建一个连续的色带。

• 绝对蛋白 真/假，用于更改 dx 从百分比（如果为假）到固定像素数（如果为真）。

• MX，我的 图例边框的边距设置为图例总大小的1.5%。

总之，下面我将添加一个图例示例的图像，其中包含所有工作中的各种选项。生成它的请求如下：

http://localhost:8081/geoserver/wms?REQUEST=GetLegendGraphic&VERSION=1.0.0&FORMAT=image/png&WIDTH=100&HEIGHT=20&LAYER=it.geosolutions:di08031_da&LEGEND_OPTIONS=forceRule:True;dx:0.2;dy:0.2;mx:0.2;my:0.2;fontStyle:bold;borderColor:0000ff;border:true;fontColor:ff0000;fontSize:18

别担心，如果它看起来像是用古老的死语写的，我将在下面解释各种参数。

栅格图例类型¶

正如您可能知道的（实际上，由于我从未写过任何关于RasterSymbolar工作的真实文档），GeoServer支持三种类型的颜色映射：

• ramp 这就是SLD 1.0所规定的，这意味着对各种颜色映射项之间的值进行加权的线性插值。

• 价值观 这是一个扩展，允许将数量链接到ColorMapEntries数量指定的颜色。未指定的值将转换为透明像素。

• 班 这是一个扩展，允许基于从ColorMapEntries数量创建的间隔进行纯分类。未指定的值将转换为透明像素。

下面我将列出在雨量浮点geotiff上使用附加样式的各种示例。

颜色映射类型是值¶

请参阅附件中的sld rainth.sld。

颜色映射类型为类¶

参见附件中的SLD降雨等级。

颜色映射类型为渐变¶

参考SLD降雨量_类.sld在附件中。请注意，第一个图例显示默认的边框行为，而第二个图例被迫为呈现文本所描述的colormap条目数量的断点颜色绘制边框。注意，每个颜色元素都有一个部分，该部分显示它所描述的colormap条目中的固定颜色（它的最低部分，下面第二个图例中的边框勾勒出的元素），而元素的上部有一个渐变，将每个元素连接到上一个元素，以指出我们使用线性插值的事实。

各种控制参数及设置方法¶

现在，我将简要说明可用于控制图例布局和内容的各种参数。这里显示了一个放置所有各种选项的请求：

http://localhost:8081/geoserver/wms?REQUEST=GetLegendGraphic&VERSION=1.0.0&FORMAT=image/png&WIDTH=100&HEIGHT=20&LAYER=it.geosolutions:di08031_da&LEGEND_OPTIONS=forceRule:True;dx:0.2;dy:0.2;mx:0.2;my:0.2;fontStyle:bold;borderColor:0000ff;border:true;fontColor:ff0000;fontSize:18

现在让我们逐个检查所有有趣的元素。请注意，我不会讨论GetLegendgraphic操作的机制，因为您可能希望参考SLD 1.0规范，我的目标是简要讨论Legend_选项参数。

• 强制规则（布尔值） 默认情况下，除非完全没有标签，否则不会绘制颜色映射项的规则来保持图例的小和紧凑。您可以通过将此参数设置为true来更改此行为。

• dx，dy，mx，my（双） 可用于设置元素之间的边距和缓冲区

• 边框（布尔值） 激活或取消激活颜色元素上的边框，以便使分隔更清晰。注意到我决定 总是 有一条线可以分割颜色映射的渐变类型的各种颜色元素。

• 边框颜色（十六进制） 允许我们将边框的颜色设置为0xrrggbb格式

cql表达式和env¶

如果在ColorMapEntry属性中使用CQL表达式（请参见 here ）要创建从env获取值的动态颜色映射，可以将用于get map的相同env参数指定给getlegendgraphic以获取所需的图例项。

与内容相关的图例¶

geoserver允许构建内容相关的图例，即其内容依赖于当前显示的地图的图例。为了支持它，getlegendgraphic调用需要以下额外参数：

• BBOX

• SRS或CRS（取决于WMS版本，SRS用于1.1.1，CRS用于1.3.0）

• SRCWIDTH和SRCHEIGHT，引用映射的大小（宽度和高度在GetLegendGraphic中已经有不同的含义）

还可以添加其他参数以更好地匹配getmap请求，例如，建议镜像筛选供应商参数，例如，cql_filter、filter、featureid、time、elevation。

通过以下图例选项参数启用内容相关评估：

• CountMatched：在规则标签的末尾添加与特定规则匹配的功能数（需要可见标签才能工作）。仅适用于矢量层。

• hideEmptyRules：隐藏与任何功能都不匹配的规则。仅当countMatched为true时才适用。

例如，假设将以下布局添加到geoserver (legend.xml 放置在 GEOSERVER_DATA_DIR/layouts ）：

<layout>
    <decoration type="legend" affinity="top,right" offset="0,0" size="auto"/>
</layout>

这将使一个图例显示在getmap响应中。以下预览请求使用布局嵌入图例并激活其中的功能计数：

http://localhost:8080/geoserver/topp/wms?service=WMS&version=1.1.0&request=GetMap&layers=topp:states&styles=&bbox=-124.73142200000001,24.955967,-66.969849,49.371735&width=768&height=330&srs=EPSG:4326&format=application/openlayers&format_options=layout:legend&legend_options=countMatched:true;fontAntiAliasing:true

结果如下：

使用独立的getlegendgraphic请求也可以实现这一点：

http://localhost:8080/geoserver/topp/wms?service=WMS&version=1.1.0&request=GetLegendGraphic&width=20&height=20&layer=topp:states&bbox=-124.73142200000001,24.955967,-66.969849,49.371735&srcwidth=768&srcheight=330&srs=EPSG:4326&format=image/png&legend_options=countMatched:true;fontAntiAliasing:true

或者使用独立的GetLegendGraphic请求隐藏空规则：

http://localhost:8080/geoserver/topp/wms?service=WMS&version=1.1.0&request=GetLegendGraphic&width=20&height=20&layer=topp:states&bbox=-101.0028076171875,31.025390625,-96.7840576171875,32.838134765625&srcwidth=768&srcheight=330&srs=EPSG:4326&format=image/png&legend_options=countMatched:true;fontAntiAliasing:true;hideEmptyRules:true

筛选器和表达式¶

过滤器编码使用 ECQL ，具有elsefilter的规则将元素“elsefilter”设置为值“true”。在样式中遇到表达式时，表达式也在ECQL中编码（包装在[]中）。

符号¶

• PointSymbolizer

  点符号将表示为一系列包含元数据和 graphics 符号（参见 here ）这些都是众所周知的 marks 或外部图形。点符号器还提供一个“URL”元素，允许客户端向GeoServer发出请求，以获取点符号的PNG图像。

  {"Point":     {
      "title": "title",
      "abstract": "abstract",
      "url": "http://localhost:9000/geoserver/kml/icon/capitals?0.0.0=",
      "size": "6",
      "opacity": "1.0",
      "rotation": "0.0",
      "graphics": [      {
        "mark": "circle",
        "fill": "#FFFFFF",
        "fill-opacity": "1.0",
        "stroke": "#000000",
        "stroke-width": "2",
        "stroke-opacity": "1",
        "stroke-linecap": "butt",
        "stroke-linejoin": "miter"
      }]}}
  

• LineSymbolizer

  行符号表示为元数据元素列表，并且 stroke parameters ，有可能有一个 graphic-stroke 元素也是。

  {"Line":     {
    "stroke": "#AA3333",
    "stroke-width": "2",
    "stroke-opacity": "1",
    "stroke-linecap": "butt",
    "stroke-linejoin": "miter"
  }}
  
  
  {"Line":       {
      "graphic-stroke":         {
        "url": "http://local-test:8080/geoserver/kml/icon/Default Styler",
        "size": "6",
        "opacity": "0.4",
        "rotation": "[(rotation*-1)]",
        "graphics": [          {
          "mark": "square",
          "fill": "#FFFF00",
          "fill-opacity": "1.0"
        }]
      },
      "stroke-opacity": "1",
      "stroke-linecap": "butt",
      "stroke-linejoin": "miter",
      "perpendicular-offset": "10"
    }}
  

• PolygonSymbolizer

  多边形符号包含 stroke parameters 和 fill parameters .

  {"Polygon":       {
    "stroke": "#000000",
    "stroke-width": "0.5",
    "stroke-opacity": "1",
    "stroke-linecap": "butt",
    "stroke-linejoin": "miter",
    "fill": "#0099CC",
    "fill-opacity": "1.0"
  }}
  

  或图形笔划和/或图形填充（如上所述）。

  {"Polygon":       {
    "graphic-stroke":         {
      "url": "http://local-test:8080/geoserver/kml/icon/Default Styler",
      "size": "6",
      "opacity": "0.4",
      "rotation": "[(rotation*-1)]",
      "graphics": [          {
        "mark": "square",
        "fill": "#FFFF00",
        "fill-opacity": "1.0"
      }]
    },
    "stroke-opacity": "1",
    "stroke-linecap": "butt",
    "stroke-linejoin": "miter",
    "graphic-fill":         {
      "url": "http://local-test:8080/geoserver/kml/icon/Default Styler",
      "size": "4",
      "opacity": "0.4",
      "rotation": "[(rotation*-1)]",
      "graphics": [          {
        "mark": "circle",
        "fill": "#FFFFFF",
        "fill-opacity": "1.0"
      }]
    }}}
  

• RasterSymbolizer

  栅格符号包含 colormap 有一个数组 entries ，每个条目包含 label ， quantity 和 color 元素。

  {"Raster":   {
    "colormap":     {
      "entries":       [
                {
          "label": "values",
          "quantity": "0",
          "color": "#AAFFAA"
        },
                {
          "quantity": "1000",
          "color": "#00FF00"
        },
                {
          "label": "values",
          "quantity": "1200",
          "color": "#FFFF00"
        },
                {
          "label": "values",
          "quantity": "1400",
          "color": "#FF7F00"
        },
                {
          "label": "values",
          "quantity": "1600",
          "color": "#BF7F3F"
        },
                {
          "label": "values",
          "quantity": "2000",
          "color": "#000000"
        }
      ],
      "type": "ramp"
    },
    "opacity": "1.0"
  }}
  

• TextSymbolizer

  文本符号包含 label 表达式，后跟一个数组 fonts 和A label-placement 包含如何放置标签的详细信息的对象。

  {"Text":         {
          "label": "[STATE_ABBR]",
          "fonts": [          {
                  "font-family": ["Times New Roman"],
                  "font-style": "Normal",
                  "font-weight": "normal",
                  "font-size": "14"
          }],
          "label-placement":           {
                  "x-anchor": "0.5",
                  "y-anchor": "0.5",
                  "rotation": "0.0"
          }
  }}
  

供应商选项¶

如果符号中包含一个或多个供应商选项，则 vendor-options 输出中包含的元素。此对象将为每个供应商选项包含一行。

"vendor-options": {
  "labelAllGroup": "true",
  "spaceAround": "10",
  "followLine": "true",
  "autoWrap": "50"
}