Customization Document Version 1.1.1

WMC reads a customization document and starts along the document.

Table Of Contents

Specification

Root element

<Wmc>
Root element.
<Overlay>
Overlay element. More than zero may be available. See Overlay element.
<Map>
Map element. Only one must be available.
<Name>
Has the name of map as a child.
<Crs>
Has the Coordinate Reference Syste as child. Currently, only EPSG:4326 and EPSG:900913 can be applied.
<Background>
Has background color as a child. This text must have "#" at the first letter, and folloing hexadecibal numbers. #AARRGGBB, #RRGGB, #ARGB, #RGB can be applied. For example, you want background to be white and opaque, write "#FFFFFFFF".
<Scaler>
Has the scaler setings as children.
<MaxValue>
Has maximum value by integer as a child. As the value more, the map is more detailed.
<MinValue>
Has minimum value by integer as a child. As the value less, the map is more wide.
<InitialPosition>
Initial position.
<Longitude>
Has longitude of initial position as child. The value must be decimal degree, not degree, minute and second.
<Latitude>
Has latitude of initial position as child. The value must be decimal degree, not degree, minute and second.
<ScalerValue>s
Has initial value for scaler as child. The value must be integer. As the value less, the map is shown more widely.

Overlay element

<Overlay>
Overlay element.
type
Common Attribute. Type name of this overlay. Currentry, KmlOverlayProperty or BitmapOverlayProperty is applied.
<Name>
Common Element. Has the name of this overlay.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this overlay is transparent. If set by 255, this overlay is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this overlay is shown or not.
<OverlayAbstract>
Common Element. Has abstract text.
<OverlayAuthority>
Common Element. Has authority information.
<Title>
Has the title, which is authority name, service name, etc.
<SiteUrl>
Has the URL referes the webpage which introduces the service.
<OverlayAttribution>
Common Element. Has information about attribution. See Attribution Element.

See KmlOverlayProperty, BitmapOverlayProperty for each type.

KmlOverlayProperty

The overlay for KML.

<Overlay>
Overlay element.
type
Common Attribute. This must be "KmlOverlayProperty".
<Name>
Common Element. Has the name of this overlay.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this overlay is transparent. If set by 255, this overlay is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this overlay is shown or not.
<OverlayAbstract>
Common Element. Has abstract text.
<OverlayAuthority>
Common Element. Has authority information.
<OverlayAttribution>
Common Element. Has information about attribution. See Attribution Element.
<Url>
Has the URL which referes the KML.

BitmapOverlayProperty

The overlay which holds layers (<Layer> elements)

<Overlay>
Overlay element.
type
Common Attribute. This must be "BitmapOverlayProperty".
<Name>
Common Element. Has the name of this overlay.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this overlay is transparent. If set by 255, this overlay is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this overlay is shown or not.
<OverlayAbstract>
Common Element. Has abstract text.
<OverlayAuthority>
Common Element. Has authority information.
<OverlayAttribution>
Common Element. Has information about attribution. See Attribution Element.
<Layer>
Has layer. More than zero may be available. See Layer element.

Layer element

Layer element which BiemapOverlay has.

<Layer>
Layer element.
type
Common Attribute. Type name of this layer. Currentry, WmsTiledLayerProperty, WmsLayerProperty, TileIndexLayerProperty or TmsLayerProperty is applied.
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text.
<Authority>
Common Element. Has authority information.
<Title>
Has the title, which is authority name, service name, etc.
<SiteUrl>
Has the URL referes the webpage which introduces the service.
<Attribution>
Common Element. Has information about attribution. See Attribution Element.

See WmsTiledLayerProperty, WmsLayerProperty, TileIndexLayerProperty, TmsLayerProperty, CyberJapan4MapLayerProperty or CyberJapan4OrthoLayerProperty for each type.

WmsTiledLayerProperty

<Layer>
Layer element.
type
Common Attirbute. Type name of this layer. This must be "WmsTiledLayerProperty".
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text.
<Authority>
Common Element. Has authority information.
<Attribution>
Common Element. Has information about attribution. See Attribution Element.
<WmsLayerParameter>
Has elements of LAYERS and STYLE perameters for WMS. More than one may be available.
<Name>
Has the text which is the element of LAYERS parameter.
<Style>
Has the text which is the element of STYLE parameter.
<BaseUrl>
Has the base URL.
<Version>
Has WMS version text. In both of WmsTiledLayerProperty and WmsLayerProperty, 1.3.0 or 1.1.1 is available.
<Transparent>
Has "true" or "false". This is used for TRANSPARENT parameter.
<MarginX>
Has integer indicating expansion margin pixels for left and right. If more than zero is set, WMC requests the image with the size expanded from the original. Width for request is 2*MarginX + original width.
<MarginY>
Has integer indicating expansion margin pixels for top and bottom. If more than zero is set, WMC requests the image with the size expanded from the orignal. Height for request is 2*MarginY + original height.

WmsLayerProperty

<Layer>
Layer element.
type
Common Attirbute. Type name of this layer. This must be "TmsLayerProperty".
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text.
<Authority>
Common Element. Has authority information.
<Attribution>
Common Element. Has information about attribution. See Attribution Element.
<WmsLayerParameter>
Has elements of LAYERS and STYLE perameters for WMS. More than one may be available.
<Name>
Has the text which is the element of LAYERS parameter.
<Style>
Has the text which is the element of STYLE parameter.
<BaseUrl>
Has the base URL.
<Version>
Has WMS version text. In both of WmsTiledLayerProperty and WmsLayerProperty, 1.3.0 or 1.1.1 is available.
<Transparent>
Has "true" or "false". This is used for TRANSPARENT parameter.

TileIndexLayerProperty

<Layer>
Layer element.
type
Common Attirbute. Type name of this layer. This must be "TileIndexLayerProperty".
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text.
<Authority>
Common Element. Has authority information.
<Attribution>
Common Element. Has information about attribution. See Attribution Element.
<Lefthand>
Has "true" or "false". If not specified, "false" by default. If "true" is set, the origin of the world is the WEST-NORTH corner. For more information, see <Lefthand> element.
<UrlRule>
Has URL generation rule.
<DigitX>
Has digit of X tile index number. If more than zero is set, the value is added left padding with 0s.
<DigitY>
Has digit of Y tile index number. If more than zero is set, the value is added left padding with 0s.
<DigitX>
Has digit of Z (zoom) tile index number. If more than zero is set, the value is added left padding with 0s.
<Format>
Has format for URL generate rule. See URL generation rule for tile index.
<ByZoom>
Has the values for each Z (zoom) value. More than one may be available.
zoom
Has the condition for Z (zoom) value.
<SubLayer>
Has {sublayer} value for specified Z (zoom) value.
<Extension>
Has {extension} value for specified Z (zoom) value.

TmsLayerProperty

The layer for TMS. This is derived class by TileIndexLayerProperty.

<Layer>
Layer element.
type
Common Attirbute. Type name of this layer. This must be "TmsLayerProperty".
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text.
<Authority>
Common Element. Has authority information.
<Attribution>
Common Element. Has information about attribution. See Attribution Element.
<Lefthand>
Inherited Element. Has "true" or "false". If not specified, "false" by default. If "true" is set, the origin of the world is the WEST-NORTH corner. For more information, see <Lefthand> element.
<BaseUrl>
Has the base URL for the service.
<Version>
Has the TMS version. This may not be set.
<Extension>
Has file extension, for example, "png" or "jpg".

For more information about URL generation rule for TMS, see URL generation rule for tile index.

CyberJapan4MapLayerProperty

The layer for Cyber Japan(External Site)

<Layer>
Layer element.
type
Common Attirbute. Type name of this layer. This must be "CyberJapan4MapLayerProperty".
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text. This layer sets this element automatically.
<Authority>
Common Element. Has authority information. This layer sets this element automatically.
<Attribution>
Common Element. Has information about attribution. See Attribution Element. This layer sets this element automatically.

CyberJapan4OrthoLayerProperty

The layer for the ortho photo of Cyber Japan(External Site)

<Layer>
Layer element.
type
Common Attirbute. Type name of this layer. This must be "CyberJapan4OrthoLayerProperty".
<Name>
Common Element. Has the name of this layer.
<Alpha>
Common Element. Has the alpha value (opacity). This must be between 0 and 255. If this is set by 0, this layer is transparent. If set by 255, this layer is opaque. Alpha value can be changed by the user while WMC is running.
<Visible>
Common Element. Has "true" or "false". This indicates whether this layer is shown or not.
<Abstract>
Common Element. Has abstract text. This layer sets this element automatically.
<Authority>
Common Element. Has authority information. This layer sets this element automatically.
<Attribution>
Common Element. Has information about attribution. See Attribution Element. This layer sets this element automatically.

Attribution elemnt

<Text>
Has the text for attribution.

URL generation rule for tile index

URL generation rule for TileIndexLayerProperty

Format of URL generation rule for TileIndexLayerProperty (<Format> element) is following:

  • Parts quoted with "{" and "}" are variables. Others are not variable. One variable can be at one or more places.
  • Avialable variable are {x}, {y}, {z}, {sublayer} and {extension}. Names are case-insensetive.
  • Substring of {x}, {y} and {z} can be used. {x:2,1} is extracted as one 3rd character of {x} (because 1st value starts with zero). {x:0,4} is extracted as 4 characters starting with top character.
  • Values of {x}, {y} and {z} are depended on current extent of WMC view. {sublayer} and {extension} are decided by <ByZoom> elements and {z} value.
  • Also WMC can use XML element which has simple value. List element, compound type or attribute cannot be used.
  • If derived class has {sublayer} or {extension}, the value is used only when it cannot be decided by <ByZoom> elements and {z} value.
  • If part between "/" and "/" is empty as the result of extracting, URL path is reduced (If the result of extracting variable along "aaa/{sublayer}/bbb" is "aaa//bbb", the result is converted into "aaa/bbb").
  • If the value has "/" with head or with tail, reduction is not performed (If {baselayer}="zzz/", the result of extracting along "{baselayer}/aaa" is "zzz//aaa").
  • If the non variable part has "//", it is not reduced (The result of extracting along "http://..." is "http://...").
Extraction along digits and Format element

Assume that customization document has following element.

<UrlRule>
  <DigitX>4<>
  <Format>/{x:0,1}/{x:2,1}/{x}/<Format>
</UrlRule>

If x=123, {x} is changed into "0123" because of <DigitX>. Extraction along <Format> results "/0/2/0123/".

URL generation rule for TmsLayerProperty

Format of URL generation rule for tile index is set by "{baseurl}/{version}/{sublayer}/{z}/{x}/{y}.{extension}". If <Version> nor <SubLayer> is not set, format is equivalent with "{baseurl}/{z}/{x}/{y}.{extension}" and elder specification.

Notice

Change from version 1.0.2

Change from version 1.0.2 are following:

  • <Overlay> element is available.
  • <Layer> element has moved from <Map> element to <Overlay type="BitmapOverlay"> element.
  • <Epsg> element is disappeared.
  • <Layer type="TileIndexLayerProperty"> is available.
  • In <Layer type=TmsLayerProperty">, <SubLayer> element is added and <Version> element is used to generate URL.

Change from WMC Version Code 18

  • In <Layer type=TmsLayerProperty">, last character of <BaseLayer> value is not processed even if the value ending with "/". If {baseurl} is "http://foo/", the result is "http://foo//{version}/{x}...". Please delete the last character if it is "/".

<Lefthand> element

By default, axis orientation for TileIndexLayerProperty and TmsLayerProperty is the righthand system. The origin is at WEST-SOUTH corner.

[Righthand system ordering]

Axis orientation of Google Maps and so on is the lefthand system. The origin is at WEST-NORTH corener.

[Lefthand system ordering]

If <Lefthand> is set by false or <Lefthand> is not set, WMC calculates tile index number along the righthand system.

If <Lefthand> is set by true, WMC calculates along the lefthand system.

Example

WMS

<?xml version="1.0" encoding="UTF-8" ?>
<Wmc>
  <Map>
   <Name>WMC Japan</Name>
    <Crs>EPSG:900913</Crs>
    <Background>#FFFFFFFF</Background>
    <MapAbstract>Simple Map in Japan.</MapAbstract>
    <MapAuthority>
      <Title>WMC</Title>
      <SiteUrl>http://www.finds.jp/wmc/index.html.en</SiteUrl>
    </MapAuthority>
    <Scaler>
      <MaxValue>17</MaxValue>
      <MinValue>3</MinValue>
    </Scaler>
  </Map>
  <Overlay type="BitmapOverlayProperty">
    <Name>Basic Map</Name>
    <Layer type="WmsLayerProperty">
      <Name>FGD Japan 25000</Name>
      <Alpha>255</Alpha>
      <Visible>true</Visible>

      <BaseUrl>http://www.finds.jp/ws/kiban25000wms.cgi?</BaseUrl>
      <Version>1.3.0</Version>
      <Transparent>true</Transparent>
      <Abstract>A simple Japanese map service using Fundamental Geospatial Data provided by Geospatial Information Authority of Japan.</Abstract>
      <Authority>
        <Title>FGDJ WMS (Approval Number GYOU-SHI No.449 2008)</Title>
        <SiteUrl>http://www.finds.jp/wsdocs/kibanwms/index.html.en</SiteUrl>
      </Authority>

      <WmsLayerParameter>
        <Name>AdmArea</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>PrefSmpl</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>JpSmpl</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>Cntr10</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>Cntr100</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>Cntr100w</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>BldA</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>WL</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>RdEdg</Name>
        <Style></Style>
      </WmsLayerParameter>
      <WmsLayerParameter>
        <Name>RailCL</Name>
        <Style></Style>
      </WmsLayerParameter>
    </Layer>
  </Overlay>
  <InitialPosition>
    <Longitude>139.7704</Longitude>
    <Latitude>35.68721</Latitude>
    <ScalerValue>14</ScalerValue>
  </InitialPosition>
</Wmc>

Download File

START (For the device has WMC)

Tiled WMS

<?xml version="1.0" encoding="UTF-8" ?>
<Wmc>
  <Map>
   <Name>WMC Japan</Name>
    <Crs>EPSG:900913</Crs>
    <Background>#FFFFFFFF</Background>
    <MapAbstract>Simple Map in Japan.</MapAbstract>
    <MapAuthority>
      <Title>WMC</Title>
      <SiteUrl>http://www.finds.jp/wmc/index.html.en</SiteUrl>
    </MapAuthority>
    <Scaler>
      <MaxValue>17</MaxValue>
      <MinValue>3</MinValue>
    </Scaler>
  </Map>
  <Overlay type="BitmapOverlayProperty">
    <Name>Basic Map</Name>
    <Layer type="WmsTiledLayerProperty">
      <Name>FGD Japan 25000</Name>
      <Alpha>255</Alpha>
      <Visible>true</Visible>
      <WmsLayerParameter>
        <Name>kiban25000:AllT</Name>
        <Style></Style>
      </WmsLayerParameter>
      <BaseUrl>http://www.finds.jp/ws/kiban25000gwc.cgi?</BaseUrl>
      <Version>1.1.1</Version>
      <Transparent>true</Transparent>
      <Abstract>A simple Japanese map service using Fundamental Geospatial Data provided by Geospatial Information Authority of Japan.</Abstract>
      <Authority>
        <Title>FGDJ WMS (Approval Number GYOU-SHI No.449 2008)</Title>
        <SiteUrl>http://www.finds.jp/wsdocs/kibanwms/index.html.en</SiteUrl>
      </Authority>
    </Layer>
  </Overlay>
  <InitialPosition>
    <Longitude>139.7704</Longitude>
    <Latitude>35.68721</Latitude>
    <ScalerValue>14</ScalerValue>
  </InitialPosition>
</Wmc>

Download File

START (For the device has WMC)

TMS

<?xml version="1.0" encoding="UTF-8" ?>
<Wmc>
  <Map>
    <Name>FGD Japan 25000</Name>
    <Crs>EPSG:900913</Crs>
    <Background>#00FFFFFF</Background>
    <MapAbstract>Shows Fundamental Geospatial Data Japan 1:25000</MapAbstract>
    <MapAuthority>
      <Title>WMC</Title>
      <SiteUrl>http://www.finds.jp/wmc/index.html.ja</SiteUrl>
    </MapAuthority>
    <Scaler>
      <MaxValue>17</MaxValue>
      <MinValue>3</MinValue>
    </Scaler>
  </Map>
  <Overlay type="BitmapOverlayProperty">
    <Name>FGD 25000</Name>
    <Layer type="TmsLayerProperty">
      <Name>FGD 25000</Name>
      <Alpha>255</Alpha>
      <Visible>true</Visible>
      <BaseUrl>http://www.finds.jp/ws/tmc/1.0.0/KBN25000ANF-900913</BaseUrl>
      <Extension>png</Extension>
      <Abstract>A simple Japanese map service using Fundamental Geospatial Data provided by Geospatial Information Authority of Japan.</Abstract>
      <Authority>
        <Title>FGDJ WMS (Approval Number GYOU-SHI No.449 2008)</Title>
        <SiteUrl>http://www.finds.jp/wsdocs/kibanwms/index.html.en</SiteUrl>
      </Authority>
    </Layer>
  </Overlay>
  <InitialPosition>
    <Longitude>139.7704</Longitude>
    <Latitude>35.68721</Latitude>
    <ScalerValue>14</ScalerValue>
  </InitialPosition>
</Wmc>

Download File

START (For the device has WMC)

TMS with <Lefthand>

<?xml version="1.0" encoding="UTF-8" ?>
<Wmc>
  <Map>
   <Name>OpenStreetMap</Name>
    <Crs>EPSG:900913</Crs>
    <Background>#FFFFFFFF</Background>
    <MapAbstract>OpenStreetMap OpenStreetMap is a free worldwide map, created by people like you.
(c) OpenStreetMap (and) contributors, CC-BY-SA.
This map uses http://tile.openstreetmap.org/ .</MapAbstract>
    <MapAuthority>
      <Title>WMC</Title>
      <SiteUrl>http://www.finds.jp/wmc/index.html.en</SiteUrl>
    </MapAuthority>
    <Scaler>
      <MaxValue>18</MaxValue>
      <MinValue>1</MinValue>
    </Scaler>
  </Map>
  <Overlay type="BitmapOverlayProperty">
    <Layer type="TmsLayerProperty">
      <Name>OSM Mapnik</Name>
      <Alpha>255</Alpha>
      <Visible>true</Visible>
      <BaseUrl>http://tile.openstreetmap.org/</BaseUrl>
      <Lefthand>true</Lefthand>
      <Extension>png</Extension>
      <Abstract>OSM Mapnik. (c) OpenStreetMap (and) contributors, CC-BY-SA.</Abstract>
      <Authority>
        <Title>Open Steeat Map</Title>
        <SiteUrl>http://www.openstreetmap.org/</SiteUrl>
      </Authority>
    </Layer>
  </Overlay>
  <InitialPosition>
    <Longitude>139.7704</Longitude>
    <Latitude>35.68721</Latitude>
    <ScalerValue>14</ScalerValue>
  </InitialPosition>
</Wmc>

Download File

START (For the device has WMC)

WMC Manryo 0.9.15 (Version Code 23) (28th October, 2012)


About Finds.jp | WHat is New | Site Map | Inquiry

HTTP | HTTPS

National Agriculture and Food Research Organization