Enable multi-layer GetMap, GetFeatureInfo to return text/mapml containing styled <map-feature>s +/- <map-tile>s from all requested layers #72
Labels
documentation
Improvements or additions to documentation
enhancement
New feature or request
GetMap
GetTile
help wanted
Extra attention is needed
idea
Comments
prushforth
added
documentation
prushforth
changed the title
prushforth
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Currently with the GeoServer MapML extension, there is no possibility of generating a text/mapml response containing a single-extent, multi-layer request template i.e. a <map-link rel="features" tref="...GetMap&layers=layer1,layer2,layer3...">. For one thing, this is because each layer has its own "Use Features" setting that is not driven by a WMS parameter. What's more, it was unclear how to serialize layers in such a request that are not "vector-capable" such as image layers.
If the GeoServer MapML extension were modified to examine the request
mapmlusefeatures:true|falsetoken, it would be possible for a request for text/mapml to generate a single <map-extent> containing a <map-link rel="features" tref="...GetMap&layers=layer1,layer2,layer3&format_options=mapmlfeatures:true..."> (wherein thetrefattribute contains a WMS GetMap URL template containing themapmlfeatures:trueformat_optionsparameter token and also contains a multi-layerlayers=parameter list value).This requirement is to establish the behaviour of the GeoServer MapML extension when it processes a multi-layer GetMap request when the
format_optionsparameter tokenmapmlmultiextentis set to false.MapML document types available from GeoServer form a conceptual tree structure, in which the nodes are document types and the edges are links, either complete URLs or templated via the MapML <map-link tref="..."> URL template. The root node in the tree is the HTML preview document, which contains a link to a GeoServer layer in text/mapml format. GeoServer's Layer and Layer Group settings pages affect the how the HTML preview document root node is configured and serialized. In particular, the "Use Tiles", "Use Features" and "Multiple Extent Elements" settings for the Layer and Layer Group editing pages will dictate the values
format_options=parameter tokens that are serialized into the HTML preview in the GetMap URL in the<layer- src="..."></layer->src URL.Inner node parameters
The middle, or internal node in the above diagram is the first level of text/mapml document available from GeoServer, linked to by the <layer- src="...request=GetMap..."> src URL in the root node, and its configuration, or state, is controled by three tokens for the
format_optionsGeoServer 'vendor' parameter. The tokens' values control, and only apply to the internal node (middle tier from diagram above) state:(The default value, or the value if the token is omitted, is false)
mapmlmultiextent:false | truemapmlmultiextent:false | true- controls the number and state of <map-extent> elements generated in the document, depending on the layers referenced by thelayers=WMS parameter. Iffalse(the default), a singleton <map-extent> element will be serialized, and that map-extent will be populated with child <map-input> and associated <map-link rel="..."> elements that conform to themapmlusefeatures:false | trueandmapmlusetiles:false | truevalues. In the following listing, the document was generated with neither parameter, so they default to false.Inner node created according to mapmlmultiextent:false parameter
In the following listing of a single layer (LayerGroup) request, the document was generated with the inner node parameters
mapmlusefeatures:false | trueandmapmlusetiles:false | truevalues set totrue. Note that the fact that the configuration uses the "GetTile" WMTS request implies that a tile cache with an appropriate GridSet has been set up by the administrator. Had no tile cache been previously configured, the generated <map-extent> would use "tile-shaped" GetMap request templates and associated <map-input>s.Inner node created according to mapmlmultiextent:false; mapmlusefeatures:true; mapmlusetiles:true, tile cache previously established
For a
format_options=mapmlmultiextent:truevalue passed to the inner node generator, if thelayersparameter is list-valued, that is, references more than a single layer in a comma-separated list OR thelayersparameter names a single GeoServer LayerGroup, the resulting text/mapml inner node document will contain one <map-extent> element per layer in thelayerslist OR per layer in the LayerGroup, with the <map-extent>s serialized according to the values of themapmlusefeaturesandmapmlusetilesformat_optionsvalues. In the following listing, both of those options' values have defaulted (tofalse), so each generated <map-extent> is configured to be a "traditional" WMS GetMap / GetFeature client:Inner node created according to mapmlmultiextent:true
Inner node created according to mapmlmultiextent:true; mapmlusefeatures:true
Inner node created according to mapmlmultiextent:true; mapmlusefeatures:true; mapmlusetiles:true
mapmlusefeatures:false | truemapmlusefeatures:false | truemapmlusetiles:false | trueLeaf node parameter
The
mapmlfeaturesformat_optionstoken value drives the creation of the leaf node document type. The middle tier node in the diagram will generate templated links embedded in <map-extent>s in the document. The <map-link tref> URL template to the leaf node text/mapml document will accordingly sometimes contain themapmlfeatures:truetoken value, which will cause GeoServer to serialize the layer and layer group content as MapML feature and/or image tile data according to the individual layer's underlying data type.mapmlfeatures:false | trueAn example leaf node document is:
The text was updated successfully, but these errors were encountered: