Multidataset

From Maria GDK Wiki
Jump to navigation Jump to search

The multidataset XML (.m6mmultidataset.xml) is used to setup and describe similar type datasets. A dataset is typically produced from the same source data/format.

All entries in this file are treated as hints and may be overridden by the map renderer.

All limits can be given as zoomlevels since Maria GDK 2.0. Use postfix "L" to parse limits as zoomlevel instead ofmapscale(f.ex. minvisible="15L" maxvisible="6L"). Mapscales will be converted to corresponding zoomlevels.

Multidataset

Example:

<multidataset>
  <globalsettings>
    <multidatasetlimits minvisible="1K" maxvisible="1000000K" 
                        simplestyle="10000K" label="10M"/>
    <resourcereferences styleroot="m6msymbols" 
                        symbols="n5000\symbols.xml" 
                        normal="n5000\ScriptCollection.xml" 
                        simple="n5000\ScriptCollection.xml" 
                        featuregrouping="n5000\featuregrouping.xml"/>
    <groupsetting drawpri="300">
      <limits minvisible="1K" maxvisible="100000K" 
              simplestyle="10000K" label="10M"/>
    </groupsetting>
  </globalsettings>

  <groupsettingtemplates>
    <groupsettingtemplate grouppattern="Arealdekke" geotype="area">
      <groupsetting  drawpri="700">
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate> 

    <groupsettingtemplate grouppattern="Arealdekke" geotype="line">
      <groupsetting  drawpri="400" >
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate> 

    <groupsettingtemplate grouppattern="Roads\Motorvei" geotype="line">
      <groupsetting  drawpri="290">
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate>

    <groupsettingtemplate grouppattern="Buildings" geotype="line">
      <groupsetting  drawpri="150">
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate> 

    <groupsettingtemplate grouppattern="Navn" geotype="point">
      <groupsetting drawpri="50">
        <limits maxvisible="10M" />
      </groupsetting>
    </groupsettingtemplate>
  </groupsettingtemplates>  

  <add filepattern="N5000.m6mindex"/>
</multidataset>

<multidataset> is the root node of the multidataset-xml.

Child element Description Properties
Global settings for multidataset. C
Templates for group settings. O R C
Filters used to add data files. O R A

Globalsettings

Child element Description Properties
multidatasetlimits Collection of scale limits that apply globally to this multidataset. O A
groupsetting Default groupsettings. O C A
resourcereferences Collection of style information hints to be used by the map renderer. A
datasetclipborder Dataset clip border setting. Used to prevent clipping of large point symbols at dataset borders. O A
Multidatasetlimits

Scale/level limits that apply gobally to this multidataset. See for further information. Also used for setting overzoom parameter.

Overzoom is used for drawing maps on levels where no data exists. The number of levels specified by the overzoom parameter controls the number of levels the mapservice can search upwards in the maplevel tree for data to draw. The first level encountered to contain data will be used.

Note: overzoom is implemented post version 2.0.1.

Attribute Description Properties
overzoom Number of levels. Default value is 0.

Example:

<multidatasetlimits minvisible="0" maxvisible="256M" simplestyle="256M" label="10M" overzoom="4"/>

Groupsetting

Groupsettings under globalsettings act as a default template for the groupsettings listed in the groupsettingtemplate section of the xml.
Child element Description Properties
limits Collection of scale limits that apply globally to this multidataset. O A
clipborder Layer clip border setting. Used to prevent clipping of large point symbols at tile borders. O A
Attribute Description Properties
drawpri Layer draw priority. Lower number equals higher priority. Default value is 100.
Limits
Attribute Description Properties
minvisible Minimum scale for rendering layer. Use of scale factors (k/K/m/M) are allowed.
maxvisible Maximum scale for rendering layer. Use of scale factors (k/K/m/M) are allowed.
simplestyle Scale threshold (minimum scale) for showing simple style.
label Scale threshold (maximum scale) for showing label.
Clipborder
Clipborder is only used when drawing points.
Attribute Description Properties
value Clip border value in pixels.

Resourcereferences

Collection of style information hints to be used by the map renderer.

Attribute Description Properties
styleroot Root folder for styling.
symbols Folder/name of symbols-xml. Location is relative to styleroot.
normal Folder/name of scriptcollection-xml. Location is relative to styleroot.
simple Folder name of simple scriptcollection-xml. Location is relative to styleroot.
featuregrouping Folder/name of featuregrouping-xml. Location is relative to styleroot.

Groupsettingtemplates

Child element Description Properties
groupsettingtemplate Feature group settings template entry. R C A

Groupsettingtemplate

Child element Description Properties
groupsetting Featuregroup settings. C A
Attribute Description Properties
grouppattern Featuregroup namepattern filter.
geotype Geotype in featuregroup. Valid values are point, line, area and unknown. Default value is unknown.
Groupsetting

See paragraph Groupsetting. Values in this groupsetting block overrides the values in the global groupsetting block.

Add

Attribute Description Properties
filepattern Filepattern filter. Used to select map data files (mainly .vtiles.sqlite). R