Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
en:help:1.4:maps:stored-create [2014/01/04 13:21] – [Advanced example] alpinequest | en:help:1.4:maps:stored-create [2015/01/19 16:04] – alpinequest |
---|
====== Custom stored maps ====== | <sub>[[en:help|Online Help]] > [[en:help:1.4|AlpineQuest 1.4]] > [[en:help:1.4:maps|Maps]]</sub> |
| |
AlpineQuest allows you to create your own stored map configurations and access a wide range of on-line map servers. | ===== Custom stored maps ===== |
| |
Stored maps are defined using an XML based file format offering a powerful configuration flexibility. Files must have a "''**.aqx**''" extension to be recognized in AlpineQuest. These AQX files must be placed on the device memory like an on-board map, and selected be added to the stored map list. | The application allows you to create your own stored map configurations and access a wide range of on-line map servers. |
| |
| Stored maps are defined using an XML based file format offering a powerful configuration flexibility. Files must have an "''**.aqx**''" extension to be recognized by the application. These AQX files must be placed on the device memory like an on-board map, and selected be added to the stored map list. |
| |
===== The AQX file format ===== | {{:icon_help.png?nolink}} Be sure to use the last application version. |
| |
The AQX format used to create custom stored maps requires only few information. | |
| |
==== Basic example ==== | ==== Basic example ==== |
<aqx version="3"> | <aqx version="3"> |
| |
<name>Map Examples</name> | <name>Basic Map Examples</name> |
| |
<source id="ID1"> | <source id="ID1"> |
<name>Map Example</name> | <name>Basic Map Example</name> |
<level type="rest"> | <level> |
<zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> | <zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> |
<servers> | <servers> |
</aqx> | </aqx> |
</file> | </file> |
\\ | |
\\ | This example is composed of the following required elements: |
This example is composed of the following required elements:\\ | |
\\ | |
| |
* The generic XML and AQX declarations: | * The generic XML and AQX declarations: |
| |
* The name of the AQX file maps set: | * The name of the AQX file maps set: |
<code xml><name>Map Examples</name></code> | <code xml><name>Basic Map Examples</name></code> |
\\ | \\ |
| |
| |
* The name of the map: | * The name of the map: |
<code xml><name>Map Example</name></code> | <code xml><name>Basic Map Example</name></code> |
\\ | \\ |
| |
* The definition of the zoom levels of the map: | * The definition of the zoom levels of the map: |
<code xml><level type="rest"></code> | <code xml><level></code> |
The "''**type**''" attribute specify type of the tile server being accessed. Use "''**rest**''" for OSM-like server.\\ | The "''**type**''" attribute specify type of the tile server being accessed. Use "''**rest**''" for OSM-like server.\\ |
\\ | \\ |
<aqx version="3"> | <aqx version="3"> |
| |
<name>Map Examples</name> | <name>Advanced Map Examples</name> |
| |
<source id="ID1_1"> | <source id="ID1_1"> |
<name>Map Example 1</name> | <name>Advanced Map Example 1</name> |
<description>Description</description> | <description>Description</description> |
<data-source>http://www.example.com/viewer/</data-source> | <data-source>http://www.example.com/viewer/</data-source> |
<copyright>2014 Example</copyright> | <copyright>2014 Example</copyright> |
<icon-data>(base 64 encoded 69*69px icon data)</icon-data> | <icon-data>(base 64 encoded 69*69px icon data)</icon-data> |
<level type="rest"> | <key-url>http://url-of-map-key</key-url> |
| <level> |
<zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> | <zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> |
<tiles-size>256</tiles-size> | <tiles-size>256</tiles-size> |
| |
<source id="ID1_2" layer="true"> | <source id="ID1_2" layer="true"> |
<name>Map Example 2</name> | <name>Advanced Map Example 2</name> |
<description><![CDATA[<html>HTML description...</html>]]></description> | <description><![CDATA[<html>HTML description...</html>]]></description> |
<level type="rest"> | <level> |
<zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> | <zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> |
<server>http://server.example.com/tiles/{$z}/{$x}/{$y}.png</server> | <server>http://server.example.com/tiles/{$z}/{$x}/{$y}.png</server> |
<source id="ID2"> | <source id="ID2"> |
<name>Quadtree Map Example</name> | <name>Quadtree Map Example</name> |
<level type="rest"> | <level> |
<zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> | <zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> |
<servers> | <servers> |
<source id="ID4"> | <source id="ID4"> |
<name>WMS Map Example</name> | <name>WMS Map Example</name> |
<level type="wms"> | <level> |
<zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> | <zoom-values>5,7,9,11,12,13,14,15,16,17</zoom-values> |
<servers> | <servers> |
</source> | </source> |
</code> | </code> |
| |
| To get the ''**<projection-resolution>**'' from a ''**ScaleDenominator**'', just multiply this value by ''**0.00028**'' (which is the "standardized rendering pixel size", in meter). |
| |
| |
| ==== Mixed servers ==== |
| |
| You can also create maps that use different services based on the zoom levels: |
| |
| <code xml> |
| <source id="ID6"> |
| <name>Mixed Map Example</name> |
| |
| <level> |
| <zoom-values>5,7,9,11,12</zoom-values> |
| <servers> |
| <server>http://server1.example.com/tiles/{$z}/{$x}/{$y}.png</server> |
| <server>http://server2.example.com/tiles/{$z}/{$x}/{$y}.png</server> |
| <server>http://server2.example.com/tiles/{$z}/{$x}/{$y}.png</server> |
| </servers> |
| </level> |
| |
| <level> |
| <zoom-values>13,14,15,16,17</zoom-values> |
| <servers> |
| <bbox-crs-code>EPSG:4326</bbox-crs-code> |
| <server><![CDATA[http://server.example.com/wms/Service?REQUEST=GetMap&VERSION=1.1.1&LAYERS=layer&FORMAT=image/png&BBOX={$bbox}&SRS=EPSG:4326&WIDTH=256&HEIGHT=256]]></server> |
| </servers> |
| </level> |
| |
| </source> |
| </code> |
| |