Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add text/mapml as a legal WMTS tile format. #45

Open
prushforth opened this issue Oct 21, 2022 · 0 comments
Open

Add text/mapml as a legal WMTS tile format. #45

prushforth opened this issue Oct 21, 2022 · 0 comments

Comments

@prushforth
Copy link
Member

prushforth commented Oct 21, 2022

Background

The MapML extension currently supports image-based map tiles, and is able to generate MapML documents that leverage the GeoWebCache and WMTS interface. For any Layer or Layer Group, the user has the option to check "Use Tiles". If the layer or layer group does not have tile caching set up for MapML TCRS gridsets, the output MapML document will be configured to generate "tile-shaped GetMap" requests that conform to the TCRS gridsets. If the user checks "Use Tiles" and sets up, via the Tile Caching layer/ layer group panel, the caching of tiles according to one or more of the standard TCRS Gridsets, then the output MapML document will be configured to issue WMTS GetTile and GetFeatureInfo requests.

Requirement

If a Layer or Layer group has "Use Features" checked:

image

enable GeoWebCache caching of vector tiles in text/mapml format, relying on the results of #50 and #48, so that in the GeoServer Tile Caching Tab of the Layer or Layer Group page, the user can select "text/mapml" as an allowed tile format:

image

The "text/mapml" format should be added to tile formats available for the layer or layer group in the WMTS Capabilities document as a <Format>text/mapml</Format> element (text/mapml is already/currently a legal <InfoFormat> value in the Capabilities document). The "text/mapml" media type should also be reflected in the layer or layer group's

<ResourceURL format="text/mapml" resourceType="tile" template="...&format=text/mapml"/> URL template list.

If the "text/mapml" tile format is checked, it should only be honoured / created for known MapML TCRS Gridsets, if any are selected; this requires that the <Format>text/mapml</Format> entries mentioned above should only be associated with TileMatrixSets defined on a MapML TCRS.

Typically, CSS style rules for MapML documents are recorded in a <map-style> element that is embedded in the MapML document. In the case of MapML documents representing individual tiles, this would be inefficient, repeating the same styles over and over for each tile. For the purpose of tile generation GetMap requests, the format_parameters="mapmltile:true" parameter should be used, which suppresses the generation of the <map-style> element, and which may in future imply other tile optimizations.

The mapmltile:true value should be specifiable via the Tile Caching panel for Layers or Layer Groups:

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant