Differences

This shows you the differences between two versions of the page.

--- en:help:v2:maps:on-demand-create [2021/03/28 11:59] – alpinequest
+++ en:help:v2:maps:on-demand-create [2021/07/22 21:55] – alpinequest
@@ Line 20: / Line 20: @@
   <description>© OpenStreetMap</description>
-  <source id="MAP01">
+  <source id="MAP_UID">
     <name>Standard Mapnik</name>
     <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
@@ Line 35: / Line 35: @@
 Note that the application will recognize the ''**{$x}**'', ''**{$y}**'' and ''**{$z}**'' variable and replace them with correct values.
-The source ''"**id**"'' field must be unique in the file, and contains only characters and numbers. It is used internally by the application to identify the data storage of the map.
+The source ''"**id**"'' field must be unique in the file, and should only contain characters and numbers. It is used internally by the application to identify the data storage of the map.
 \\
@@ Line 50: / Line 50: @@
   <description>© OpenStreetMap</description>
-  <source id="MAP01" type="topo">
+  <source id="MAP_UID" type="topo">
     <name>Standard Mapnik</name>
@@ Line 75: / Line 75: @@
 </aqx>
 </file>
+The optional ''"**type**"'' attribute allows to define the type of the map. If no preview is available, the application will use common preview based on the map type. Can be one of ''"**roads**"'', ''"**topo**"'', ''"**satellite**"'', ''"**hybrid**"'', ''"**nautical**"'', ''"**aeronautical**"'', ''"**historical**"'', ''"**hillshade**"'', ''"**contours**"''.
 An ''**<outline>**'' tag (pairs of longitudes/latitudes, space separated) can be used to define the area covered by the map. When the map is selected while another area is displayed, the application will ask the user if he wants to move the map over the covered area.
@@ Line 83: / Line 85: @@
 The ''**<update-delay>**'' tag indicates after how many time the stored map data should be updated if it's used again. The default is ''**None**'', meaning the application will never try to update the stored data. Must end with ''**D**'' (number of days), ''**W**'' (weeks), ''**M**'' (months) or ''**Y**'' (years). For example, ''**3M**'' means 3 months. Use ''**0D**'' to force the application to update the data on each display.
-The optional ''"**type**"'' attribute allows to define the type of the map. If no preview is available, the application will use common preview based on the map type. Can be one of ''"**roads**"'', ''"**topo**"'', ''"**satellite**"'', ''"**hybrid**"'', ''"**nautical**"'', ''"**aeronautical**"'', ''"**historical**"'', ''"**hillshade**"'', ''"**contours**"''.
+You can limit the number of threads used to download the map using the ''**<max-threads>**'' tag. The default and maximum value is ''**3**''.
-==== Map layer ====
+The ''**<key-url>**'' tag can be used to provide a link to the key (legend) of the map. The map key is available from the menu of a map.
+The ''**<user-agent>**'' and ''**<referer>**'' tags allow you to specify what is sent in the HTTP get headers when contacting the map server.
+\\
+===== Map layer =====
 \\
 The difference between regular maps and map layers is that a map layer is added over the current map when being selected. This is usually used for maps having a transparent background. Here is how to define a map layer:
 <code xml>
-  <source id="LAYER01" layer="true" opacity="50">
+  <source id="MAP_UID" layer="true" opacity="50">
     <name>Map Layer Example</name>
     <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
@@ Line 107: / Line 115: @@
 <code xml>
-  <source id="MAP02">
+  <source id="MAP_UID">
     <name>Quadtree Map Example</name>
     <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
       <server><![CDATA[https://map.example.com/tiles/{$q}]]></server>
+    </zoom-levels>
+  </source>
+</code>
+\\
+===== Force a particular map projection =====
+\\
+By default, the application uses the "WGS 84 / Pseudo-Mercator" (EPSG:3857) map projection. You can force a different map projection using the ''**<projection-code>**'' tag:
+<code xml>
+  <source id="MAP_UID_1">
+    <name>KKJ/4 Projection</name>
+    <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
+      <projection-code>EPSG:2394</projection-code>
+      <server><![CDATA[https://map.example.com/tiles/{$z}/{$x}/{$y}]]></server>
+    </zoom-levels>
+  </source>
+</code>
+In case you want to use map projection which is not known by the application, you can import its WKT definition:
+<code xml>
+  <import-ogc-wkt-def code="MY_2394_DEF">PROJCS["KKJ / Finland zone 4",GEOGCS["KKJ",DATUM["Kartastokoordinaattijarjestelma_1966",SPHEROID["International 1924",6378388,297,AUTHORITY["EPSG","7022"]],AUTHORITY["EPSG","6123"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.01745329251994328,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4123"]],UNIT["metre",1,AUTHORITY["EPSG","9001"]],PROJECTION["Transverse_Mercator"],PARAMETER["latitude_of_origin",0],PARAMETER["central_meridian",30],PARAMETER["scale_factor",1],PARAMETER["false_easting",4500000],PARAMETER["false_northing",0],AUTHORITY["EPSG","2394"],AXIS["Y",EAST],AXIS["X",NORTH]]</import-ogc-wkt-def>
+  <source id="MAP_UID_2">
+    <name>KKJ/4 Projection</name>
+    <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
+      <projection-code>MY_2394_DEF</projection-code>
+      <server><![CDATA[https://map.example.com/tiles/{$z}/{$x}/{$y}]]></server>
     </zoom-levels>
   </source>
@@ Line 122: / Line 159: @@
 <code xml>
-  <source id="MAP04">
+  <source id="MAP_UID">
     <name>WMS Map Example</name>
     <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
@@ Line 144: / Line 181: @@
   <import-ogc-wkt-def code="EPSG:4218">GEOGCS["Bogota 1975",DATUM["Bogota_1975",SPHEROID["International 1924",6378388,297,AUTHORITY["EPSG","7022"]],TOWGS84[307,304,-318,0,0,0,0],AUTHORITY["EPSG","6218"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.01745329251994328,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4218"]]</import-ogc-wkt-def>
-  <source id="MAP05">
+  <source id="MAP_UID">
     <name>WMTS Map Example</name>
@@ Line 187: / Line 224: @@
 <code xml>
-  <source id="MAP03">
+  <source id="MAP_UID">
     <name>Custom Variables Map Example</name>
     <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
@@ Line 216: / Line 253: @@
   <param name="key">8451-5814-5311</param>
-  <source id="MAP01">
+  <source id="MAP_UID_1">
     <name>Map 1</name>
     <zoom-levels z="5,6,7,8,9,10,11,12,13,14,15">
@@ Line 223: / Line 260: @@
   </source>
-  <source id="MAP02">
+  <source id="MAP_UID_2">
     <name>Map 2</name>
     <zoom-levels z="5,6,7,8,9,10,11,12,13,14,15">