Use this page to collect all maps usable on Viking, including the configuration for them.
But be aware there are much more updated details in the latest Viking man page!
It is possible to add new map sources.
The file is <USER HOME DIRECTORY>/.config/viking/maps.xml - The latest example maps.xml
Hence for UNIX like systems:
Which can be referenced on the command line as ~/.config/viking/maps.xml
For versions prior to v1.9 it uses the location <USER HOME DIRECTORY>/.viking/maps.xml
Note that for versions v1.9 onwards it checks the old location to maintain using your existing configuration if it exists.
For Windows it is typically:
For other Operating Systems and more information see http://en.wikipedia.org/wiki/Home_directory
The primary related properties are:
id
label
name
hostname
url
the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z (zoom level) , X, and Y (e.g. "/%d/%d/%d.png") in that order.
Note for URL strings that contain special characters such as '&' and ' ' have to be converted to the URL version so '&' becomes '&' and ' ' becomes '%20'.
You can put the whole (parametrized) URL in this field (i.e. https://hostname/directory/%d/%d/%d.png) and skip having a hostname field above (old versions of Viking <1.7 had to use both hostname and url parts).
Since using the printf style mechanism the ordering of the substituted fields can be changed via positional argument specifiers. e.g. to the order like X,Y,Z use: %2$d/%3$d/%1$d/
Further optional parameters include but not limited to:
For OpenStreetMap resources: http://wiki.openstreetmap.org/wiki/Category:Maps
The start and end of the maps.xml file should be the top level objects container (note the plural form). i.e.
<objects>
...
</objects>
Then in between this top level markers, the individual map object entries are placed.
The following examples have just the individual map entries.
Built-in.
<object class="VikSlippyMapSource">;
<property name="label">OpenStreetMap (Mapnik)</property>
<property name="hostname">tile.openstreetmap.org</property>
<property name="url">/%d/%d/%d.png</property>
<property name="id">13</property>
<property name="copyright">© OpenStreetMap contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.openstreetmap.org/copyright</property>
</object>
Built-in.
<object class="VikSlippyMapSource">
<property name="label">BlueMarble</property>
<property name="hostname">s3.amazonaws.com</property>
<property name="url">/com.modestmaps.bluemarble/%d-r%3$d-c%2$d.jpg</property>
<property name="id">15</property>
<property name="copyright">© NASA's Earth Observatory</property>
<property name="license">NASA Terms of Use</property>
<property name="license-url">http://visibleearth.nasa.gov/useterms.php</property>
</object>
See http://visibleearth.nasa.gov/
Hosting of maps is provided via Modest Maps
<object class="VikSlippyMapSource">
<property name="label">OSM Germany</property>
<property name="hostname">tile.openstreetmap.de/</property>
<property name="url">tiles/osmde/%d/%d/%d.png</property>
<property name="id">45</property>
<property name="copyright">© OpenStreetMap contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.openstreetmap.org/copyright</property>
</object>
http://tile.openstreetmap.de/tiles/osmde/11/1019/687.png
In order to add relief everywhere.
Example URL: http://toolserver.org/~cmarqu/hill/7/67/45.png
<object class="VikSlippyMapSource">
<property name="label">Hillshading</property>
<property name="hostname">toolserver.org</property>
<property name="url">/~cmarqu/hill/%d/%d/%d.png</property>
<property name="id">500</property>
</object>
http://www.thunderforest.com/landscape/
<object class="VikSlippyMapSource">
<property name="label">Thunderforest Landscape</property>
<property name="hostname">tile3.opencyclemap.org/</property>
<property name="url">landscape/%d/%d/%d.png</property>
<property name="id">44</property>
<property name="copyright">Tiles courtesy of Andy Allan © OpenStreetMap contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.openstreetmap.org/copyright</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">FOSM (Falcon)</property>
<property name="hostname">map.4x4falcon.com</property>
<property name="url">/default/%d/%d/%d.png</property>
<property name="id">116</property>
<property name="copyright">CC BY SA</property>
</object>
Interesting sources? http://maps-for-free.com/
<object class="VikSlippyMapSource">
<property name="label">Waymarked Trails Hiking</property>
<property name="hostname">tile.waymarkedtrails.org</property>
<property name="url">/hiking/%d/%d/%d.png</property>
<property name="id">701</property>
<property name="license">CC-by-SA 3.0 / ODBl</property>
<property name="license-url">http://creativecommons.org/licenses/by-sa/3.0/de/deed.en</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Waymarked Trails Cycling</property>
<property name="hostname">tile.waymarkedtrails.org</property>
<property name="url">/cycling/%d/%d/%d.png</property>
<property name="id">702</property>
<property name="license">CC-by-SA 3.0 / ODBl</property>
<property name="license-url">http://creativecommons.org/licenses/by-sa/3.0/de/deed.en</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Waymarked Trails MTB</property>
<property name="hostname">tile.waymarkedtrails.org</property>
<property name="url">/mtb/%d/%d/%d.png</property>
<property name="id">703</property>
<property name="license">CC-by-SA 3.0 / ODBl</property>
<property name="license-url">http://creativecommons.org/licenses/by-sa/3.0/de/deed.en</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Waymarked Trails Inline Skating</property>
<property name="hostname">tile.waymarkedtrails.org</property>
<property name="url">/skating/%d/%d/%d.png</property>
<property name="id">704</property>
<property name="license">CC-by-SA 3.0 / ODBl</property>
<property name="license-url">http://creativecommons.org/licenses/by-sa/3.0/de/deed.en</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Waymarked Trails Riding</property>
<property name="hostname">tile.waymarkedtrails.org</property>
<property name="url">/riding/%d/%d/%d.png</property>
<property name="id">705</property>
<property name="license">CC-by-SA 3.0 / ODBl</property>
<property name="license-url">http://creativecommons.org/licenses/by-sa/3.0/de/deed.en</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Waymarked Trails Winter Sport Slopes</property>
<property name="hostname">tile.waymarkedtrails.org</property>
<property name="url">/slopes/%d/%d/%d.png</property>
<property name="id">706</property>
<property name="license">CC-by-SA 3.0 / ODBl</property>
<property name="license-url">http://creativecommons.org/licenses/by-sa/3.0/de/deed.en</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">4umaps</property>
<property name="hostname">tileserver.4umaps.eu</property>
<property name="url">/%d/%d/%d.png</property>
<property name="copyright">© 4UMaps.eu © OpenStreetMap and contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.4umaps.eu/terms-of-use-copyright.aspx</property>
<property name="id">801</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">OpenTopoMap</property>
<property name="hostname">a.tile.opentopomap.org</property>
<property name="url">/%d/%d/%d.png</property>
<property name="follow-location">2</property>
<property name="copyright">Kartendaten: © OpenStreetMap-Mitwirkende, SRTM | Kartendarstellung: © OpenTopoMap</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">https://creativecommons.org/licenses/by-sa/3.0/</property>
<property name="id">901</property>
</object>
These include the Water Bodies too and streams etc.
Configuration:
<object class="VikSlippyMapSource">
<property name="label">TopOSM-ColorRelief</property>
<property name="hostname">tile1.toposm.com</property>
<property name="url">/us/color-relief/%d/%d/%d.jpg</property>
<property name="id">206</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">TopOSM-Contours</property>
<property name="hostname">tile1.toposm.com</property>
<property name="url">/us/contours/%d/%d/%d.png</property>
<property name="id">207</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">TopOSM-Features</property>
<property name="hostname">tile1.toposm.com</property>
<property name="url">/us/features/%d/%d/%d.png</property>
<property name="id">208</property>
</object>
<object class="VikSlippyMapSource">
<property name="name">NOAA Charts</property>
<property name="label">NOAA Charts</property>
<property name="url">https://tileservice.charts.noaa.gov/tiles/50000_1/%d/%d/%d.png</property>
<property name="copyright">NOAA</property>
<property name="license">NOAA</property>
<property name="license-url">https://www.cio.noaa.gov/services_programs/info_quality.html</property>
<property name="id">802</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">CalTopo</property>
<property name="hostname">s3-us-west-1.amazonaws.com</property>
<property name="url">/caltopo/topo/%d/%d/%d.png?v=1</property>
<property name="id">40</property>
<property name="copyright">CalTopo Terms of Use</property>
<property name="license">CalTopo Terms of Use</property>
<property name="license-url">http://caltopo.com/</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Stamen Terrain</property>
<property name="hostname">tile.stamen.com</property>
<property name="url">/terrain/%d/%d/%d.png</property>
<property name="id">112</property>
<property name="copyright">Map tiles by Stamen Design, under CC BY 3.0. Data by OpenStreetMap, under CC BY SA.</property>
<property name="license">CC BY 3.0</property>
<property name="license-url">http://creativecommons.org/licenses/by/3.0</property>
</object>
OpenTrackMap - Czech Republic - Czech Tourist Club Hiking Tracks Network
<object class="VikSlippyMapSource">
<property name="label">Czech Opentrackmap (static)</property>
<property name="hostname">opentrackmap.no-ip.org</property>
<property name="url">/tiles/%d/%d/%d.png</property>
<property name="id">04201</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Czech Opentrackmap (tracks)</property>
<property name="hostname">opentrackmap.no-ip.org</property>
<property name="url">/tracks/%d/%d/%d.png</property>
<property name="id">04202</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Czech Opentrackmap (contours)</property>
<property name="hostname">opentrackmap.no-ip.org</property>
<property name="url">/contours/%d/%d/%d.png</property>
<property name="id">04203</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Czech Opentrackmap (hillshade)</property>
<property name="hostname">opentrackmap.no-ip.org</property>
<property name="url">/hillshade/%d/%d/%d.png</property>
<property name="id">04204</property>
</object>
Further details at OS Opendata
<object class="VikSlippyMapSource">
<property name="label">OS Street View</property>
<property name="hostname">os.openstreetmap.org</property>
<property name="url">/sv/%d/%d/%d.png</property>
<property name="id">500</property>
<property name="copyright">© Crown copyright and database rights 2010</property>
<property name="license">Open Government Licence for public sector information</property>
<property name="license-url">http://www.nationalarchives.gov.uk/doc/open-government-licence/open-government-licence.htm</property>
</object>
Further details at ITO OSM Analysis
<object class="VikSlippyMapSource">
<property name="label">ITO OS Locator</property>
<property name="hostname">tiles.itoworld.com</property>
<property name="url">/os_locator/%d/%d/%d.png</property>
<property name="id">501</property>
</object>
High resolution view of Toulouse.
<object class="VikSlippyMapSource">
<property name="label">Orthophotoplans Toulouse 2011</property>
<property name="hostname">wms.openstreetmap.fr</property>
<property name="url">/tms/1.0.0/toulouse_ortho2011/%d/%d/%d.png</property>
<property name="id">510</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Orthophotoplans Toulouse 2007</property>
<property name="hostname">wms.openstreetmap.fr</property>
<property name="url">/tms/1.0.0/toulouse_ortho2007/%d/%d/%d.png</property>
<property name="id">511</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Statkart topo raster</property>
<property name="hostname">opencache.statkart.no</property>
<property name="url">/gatekeeper/gk/gk.open_gmaps?layers=toporaster2&zoom=%d&x=%d&y=%d</property>
<property name="copyright">© Kartverket</property>
<property name="license">Kartverket Terms of Use, creative commons by 3.0 no</property>
<property name="license-url">http://statkart.no/Kart/Kartverksted/Lisens/</property>
<property name="id">4700</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Statkart topo</property>
<property name="hostname">opencache.statkart.no</property>
<property name="url">/gatekeeper/gk/gk.open_gmaps?layers=topo2&zoom=%d&x=%d&y=%d</property>
<property name="copyright">© Kartverket</property>
<property name="license">Kartverket Terms of Use, creative commons by 3.0 no</property>
<property name="license-url">http://statkart.no/Kart/Kartverksted/Lisens/</property>
<property name="id">4701</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Statkart sjøkart</property>
<property name="hostname">opencache.statkart.no</property>
<property name="url">/gatekeeper/gk/gk.open_gmaps?layers=sjo_hovedkart2&zoom=%d&x=%d&y=%d</property>
<property name="copyright">© Kartverket</property>
<property name="license">Kartverket Terms of Use, creative commons by 3.0 no</property>
<property name="license-url">http://statkart.no/Kart/Kartverksted/Lisens/</property>
<property name="id">4702</property>
</object>
Example : http://maps.refuges.info/hiking/%z/%x/%y.png
<object class="VikSlippyMapSource">
<property name="label">OpenHikingMap</property>
<property name="hostname">maps.refuges.info</property>
<property name="url">/hiking/%d/%d/%d.png</property>
<property name="id">100</property>
</object>
https://wiki.openstreetmap.org/wiki/Hiking/openhikingmap
http://www.openwandelkaart.nl/
<object class="VikSlippyMapSource">
<property name="label">Public Transport Map</property>
<property name="hostname">tile.xn--pnvkarte-m4a.de</property>
<property name="url">/tilegen/%0d/%d/%d.png</property>
<property name="id">101</property>
</object>
Built-in.
<object class="VikSlippyMapSource">
<property name="label">OpenStreetMap (Cycle)</property>
<property name="hostname">b.tile.opencyclemap.org</property>
<property name="url">/cycle/%d/%d/%d.png</property>
<property name="id">17</property>
<property name="copyright">© OpenStreetMap contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.openstreetmap.org/copyright</property>
</object>
Example: http://a.tile.opencyclemap.org/cycle/7/67/44.png
Interesting Designs from Stamen Designs
Up to Zoom level 12
<object class="VikSlippyMapSource">
<property name="label">Stamen Watercolor</property>
<property name="hostname">tile.stamen.com</property>
<property name="url">/watercolor/%d/%d/%d.jpg</property>
<property name="id">110</property>
<property name="copyright">Map tiles by Stamen Design, under CC BY 3.0. Data by OpenStreetMap, under CC BY SA.</property>
<property name="license">CC BY 3.0</property>
<property name="license-url">http://creativecommons.org/licenses/by/3.0</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Stamen Toner</property>
<property name="hostname">tile.stamen.com</property>
<property name="url">/toner/%d/%d/%d.png</property>
<property name="id">111</property>
<property name="copyright">Map tiles by Stamen Design, under CC BY 3.0. Data by OpenStreetMap, under CC BY SA.</property>
<property name="license">CC BY 3.0</property>
<property name="license-url">http://creativecommons.org/licenses/by/3.0</property>
</object>
Cf. http://wiki.openstreetmap.org/wiki/OpenSeaMap
Note: This is a simple overlay with transparency. Only high detailed zoom levels are available.
Example: http://tiles.openseamap.org/seamark/15/17484/10492.png
<object class="VikSlippyMapSource">
<property name="label">OpenSeaMap</property>
<property name="hostname">tiles.openseamap.org</property>
<property name="url">/seamark/%d/%d/%d.png</property>
<property name="id">600</property>
<property name="copyright">© OpenStreetMap contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.openstreetmap.org/copyright</property>
</object>
About the GPS Trace Layer
<object class="VikSlippyMapSource">
<property name="label">OSM GPS Traces</property>
<property name="hostname">c.gps-tile.openstreetmap.org</property>
<property name="url">/lines/%d/%d/%d.png</property>
<property name="id">34</property>
<property name="copyright">© OpenStreetMap contributors</property>
<property name="license">CC-BY-SA</property>
<property name="license-url">http://www.openstreetmap.org/copyright</property>
</object>
From http://openweathermap.org/
You will want to ensure these are above a base road/topo like map and set the Alpha value to around 200 so that these weather maps allow showing an underneath map layer.
<object class="VikSlippyMapSource">
<property name="label">Open Weather Map - Clouds</property>
<property name="hostname">tile.openweathermap.org</property>
<property name="url">/map/clouds/%d/%d/%d.png</property>
<property name="id">119</property>
<property name="copyright">Data CC-By-SA by OpenWeatherMap.</property>
<property name="license">CC BY SA 2.0</property>
<property name="license-url">http://openweathermap.org/copyright</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Open Weather Map - Precipitation</property>
<property name="hostname">tile.openweathermap.org</property>
<property name="url">/map/precipitation/%d/%d/%d.png</property>
<property name="id">120</property>
<property name="copyright">Data CC-By-SA by OpenWeatherMap.</property>
<property name="license">CC BY SA 2.0</property>
<property name="license-url">http://openweathermap.org/copyright</property>
</object>
<object class="VikSlippyMapSource">
<property name="label">Open Weather Map - Wind</property>
<property name="hostname">tile.openweathermap.org</property>
<property name="url">/map/wind/%d/%d/%d.png</property>
<property name="id">121</property>
<property name="copyright">Data CC-By-SA by OpenWeatherMap.</property>
<property name="license">CC BY SA 2.0</property>
<property name="license-url">http://openweathermap.org/copyright</property>
</object>
To be really useful Viking needs to support:
See the file imagery.xml which powers the OSM Editor Potlatch2. One should be able to convert any of those entries into an equivalent Viking XML block (don't forget to assign a new Id number for Viking's use and split the url appropriately).
Just the roads (no land or sea areas)
<object class="VikSlippyMapSource">
<property name="label">MapQuest Open Roads</property>
<property name="hostname">otile2.mqcdn.com</property>
<property name="url">/tiles/1.0.0/hyb/%d/%d/%d.png</property>
<property name="id">35</property>
<property name="copyright">Tiles Courtesy of MapQuest © OpenStreetMap contributors</property>
<property name="license">MapQuest Specific</property>
<property name="license-url">http://developer.mapquest.com/web/info/terms-of-use</property>
</object>
Main Wiki: Data
Main Wiki: Main_Page
Main Wiki: Support
Adding ICGC (Catalonia maps)
Last edit: Josep Pujadas-Jubany 2021-03-05
15-jul-2022
Changed JPG images for PNG images. JPG images not more available. Only PNG images with transparency capability at ICGC (Catalonia). Arranged also Topo URL, recommended by ICGC services.
Server is a little bit busy. So, same 503 errors downloading tiles are normal. Don't worry about.
Orto
https://geoserveis.icgc.cat/icc_mapesmultibase/noutm/wmts/orto/GRID3857/%d/%d/%d.png
Topo
https://geoserveis.icgc.cat/icc_mapesmultibase/noutm/wmts/topo/GRID3857/%d/%d/%d.png
Examples
& at url
You said (above):
Note for URL strings that contain special characters such as '&' and ' ' have to be converted to the URL version so '&' becomes '&' and ' ' becomes '%20'.
Wrong for me (running Viking 1.6 on Linux Ubuntu 16.04 LTS).
&
must be changed by&
because it's XML code ( https://stackoverflow.com/questions/7823813/how-can-i-use-character-in-xml-code )You can test the URL errors invoking viking from a terminal. You will see curl petitions and 501 error server responses.
Thanks for reporting/noticing this. It is now fixed. This was always the intention (may be it worked in the older wiki version) but wasn't displaying correctly - it literally had
&
but that comes out as just a single & - so now its&amp;
- in the wiki source :) !Ok, thanks for your quick answer!
I had the same problem writing about. I had to use the
</>
option!Adding IGN Spain maps
More maps from OsmAnd project
https://osmand.net/ comes with a lot of additional online maps.
Its https://github.com/osmandapp/osmandapp.github.io/blob/master/website/tile_sources.xml file contains a lot of URLs. Where it says
{0} {1} {2}
is%d %d %d
for Viking.I see, there is no edit button on this wiki.
OK, please have a supervisor add at the top:
"Much more updated details in the newer "man viking" page.
Last edit: jidanni 2024-07-06
@jidanni - I've added you into Viking 'Members' group - thus you'll now should have access to modify this Wiki
Norwegian maps from "Statens Kartverk" has changed the service on there site (see Kartverket)
I do not fully understand how to change:
I tried to change it to:
But this is obviously correct, anyone able to figure out what's the right config?
The normal (Viking) order for tile reference components is Z, X, Y as per:
https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames
But from that Karverket leaflet config guide - their config is now Z, Y, X.
Thus for Viking config, there are two ways to achieve this. One way (as noted at the top of this page) is via the C printf parameter ordering, the other perhaps easier way is to add the line following line into your new version:
Which seems to work for me, HTH. I'll update the wiki page in due course.
Thank you @robbieonsea. I did not notice that they had switched X and Y at Kartverket, and for sure I was not able to figure out
name="switch-xy">TRUE
.This works very well. Thank you one more time.