Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
en:help:v2:maps:on-demand-create [2019/04/21 13:24]
alpinequest
en: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 35: Line 35:
 Note that the application will recognize the ''​**{$x}**'',​ ''​**{$y}**''​ and ''​**{$z}**''​ variable and replace them with correct values. 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 contains only characters and numbers. It is used internally by the application to identify the data storage of the map.
  
 \\ \\
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**"''​. 
 + 
 +==== 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 113: 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 140: 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>​

Choose language:

Online help
· Index
· Maps & Layers
    · Elevations
· Placemarks
    · Search
    · Measure
    · Auto-routing
· Positioning
    · Track recorder
· Orientation
· Workspaces
· Settings
· FAQ