Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
en:help:v2:maps:on-demand-create [2019/05/01 09:29] alpinequesten:help:v2:maps:on-demand-create [2019/05/01 09:45] alpinequest
Line 3: Line 3:
 ====== How to create a custom map? ====== ====== How to create a custom map? ======
 \\ \\
-The application uses an XML based format for its maps configuration. Files must have an ''**.AQX**'' extention and be placed in the "''**[application folder]/cache/custom-maps/**''folder.+The application uses an XML based format for its maps configuration. Files must have an ''"**.aqx**"'' extention and be placed in the ''"**[application folder]/cache/custom-maps/**"'' folder.
  
 See [[en:help:v2:settings:storage#how_to_locate_the_application_folder|how to locate the application folder here]]. See [[en:help:v2:settings:storage#how_to_locate_the_application_folder|how to locate the application folder here]].
Line 15: Line 15:
 <file xml TEST1.AQX> <file xml TEST1.AQX>
 <?xml version="1.0" encoding="utf-8" ?> <?xml version="1.0" encoding="utf-8" ?>
-<aqx version="8">+<aqx version="9">
  
   <name>Simple Test AQX</name>   <name>Simple Test AQX</name>
Line 45: Line 45:
 <file xml TEST2.AQX> <file xml TEST2.AQX>
 <?xml version="1.0" encoding="utf-8" ?> <?xml version="1.0" encoding="utf-8" ?>
-<aqx version="8">+<aqx version="9">
  
   <name>Simple Test AQX</name>   <name>Simple Test AQX</name>
   <description>© OpenStreetMap</description>   <description>© OpenStreetMap</description>
  
-  <source id="MAP01">+  <source id="MAP01" type="topo">
      
     <name>Standard Mapnik</name>     <name>Standard Mapnik</name>
Line 80: Line 80:
 {{ :en:help:v2:maps:on-demand-create-preview-2.jpg?nolink }} {{ :en:help:v2:maps:on-demand-create-preview-2.jpg?nolink }}
  
-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). ''**3M**'' means ''**3 months**''. Use ''**0D**'' to force the application to update the data on each display.+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**"''.
  
-===== Advanced example =====+==== 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">
 +    <name>Map Layer Example</name>
 +    <zoom-levels z="3,5,7,8,9,10,11,12,13,14,15,16,17">
 +      <server><![CDATA[http://a.tile.openstreetmap.org/{$z}/{$x}/{$y}.png]]></server>
 +    </zoom-levels>
 +  </source>
 +</code>
  
 +The optional ''"**opacity**"'' attribute allows to define an initial opacity, given in percent.
  
 \\ \\
Line 120: Line 130:
 </code> </code>
  
-The "''**set**''attribute defines the name of the custom variable, the "''**type**''attribute tells how to display the variable (either ''**int**'', ''**long**'', ''**float**'' or ''**double**'').+The ''"**set**"'' attribute defines the name of the custom variable, the ''"**type**"'' attribute tells how to display the variable (either ''"**int**"'', ''"**long**"'', ''"**float**"'' or ''"**double**"'').
  
 \\ \\
Line 147: Line 157:
  
 <?xml version="1.0" encoding="utf-8" ?> <?xml version="1.0" encoding="utf-8" ?>
-<aqx version="8">+<aqx version="9">
  
   <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>   <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>