table of contents
VIKING(1) | Viking 1.8 | VIKING(1) |
NAME¶
viking - program to manage GPS data
SYNOPSIS¶
viking [-d | --debug] [-V |
--verbose]
[--latitude degrees]
[--longitude degrees]
[-z | --zoom ZoomLevelOSM] [-m |
--map MapId] [-x | --external]
[file...] | [-]
viking [-h | --help]
viking [-v | --version]
DESCRIPTION¶
Viking is a program to manage GPS data.
You can import and plot tracks, routes and waypoints, show OpenStreetMap (OSM) and/or other maps, generate maps (using Mapnik), geotag images, add coordinate lines, make new tracks, routes and waypoints, hide different things, etc. It is written mainly in C with some C++ and uses the GTK+ 2 toolkit. It is available for Linux, other POSIX operating systems and Windows.
Homepage: http://viking.sf.net
Viking is licensed under the GNU GPL.
OPTIONS¶
file
-
-d, --debug
-V, --verbose
-?, --help
-v, --version
--latitude
--longitude
-z, --zoom
-m, --map
-e, --external
This is in contrast to importing the data and storing it in the Viking file.
EXTENDING VIKING¶
Currently, viking has some extension points based on configuration files. The file format is heavily inspired by the GtkBuilder file format: you specify the class of the GObject to build and set its properties. Technically, it is a XML file containing a "objects" root element. Inside this element, you set a collection of "object".
Here is an example:
<objects>
<object class="ClassName">
<property name="property_name1">Property value</property>
<property name="property_name2">Property value</property>
</object>
... <objects>
You can find more examples in the documentation part of the distribution.
Map Source. It is possible to add new map's sources. The file is ~/.viking/maps.xml. An example of the file in the distribution doc/examples/maps.xml. The VikSlippyMapSource allows to declare any map's source working like OpenStreetMap. It supports the following properties:
id
name
label
hostname
url
Note
The full parametrized address can just be put in the URL field and the hostname field doesn't need specifying.
e.g. "https://tile.openstreetmap.org/%d/%d/%d.png"
zoom-min (optional)
zoom-max (optional)
See Zoom Levels[1]
lat-min (optional)
lat-max (optional)
lon-min (optional)
lon-max (optional)
file-extension (optional)
If the tile source URL ends in something other than .png, then this parameter will need to match it.
This can also be useful in reading a tileset from other software which may name tiles in an alternative form, e.g. for Mobile Atlas creator it names them .png.tile
Note
The file types actually usable are those supported by GDK Pixbuf Library, which includes at least PNG and JPEG.
Note
Remember to include the beginning '.' when specifying this parameter.
switch-xy (optional)
The default is false.
check-file-server-time (optional)
The default is false.
use-etag (optional)
The ETag value is stored in a separate file in the same directory as the tile to enable checking the value across multiple runs of the program.
tilesize-x (optional)
tilesize-y (optional)
scale (optional)
Note
Use a value of 2 to represent high res tiles. Don't change the tilesize as the internal display size is still based on 256 pixels.
id
label
hostname
url
check-file-server-time (optional)
zoom-min (optional)
zoom-max (optional)
lat-min (optional)
lat-max (optional)
lon-min (optional)
lon-max (optional)
The VikWmscMapSource allows to declare any WMS or WMS-C service. It supports the following properties (as per VikSlippyMapSource above):id
label
hostname
url
check-file-server-time (optional)
zoom-min (optional)
zoom-max (optional)
lat-min (optional)
lat-max (optional)
lon-min (optional)
lon-max (optional)
Go-to search engines. It is possible to add new new search engines for the "Go-To" feature. The file is ~/.viking/goto_tools.xml. An example of the file in the distribution doc/examples/goto_tools.xml. Currently, there is a single object class available: VikGotoXmlTool. Such feature allows to declare any search engine using a XML format as result. The related properties are:
label
url-format
lat-path
lat-attr (optional)
lon-path
lon-attr (optional)
External tools. It is possible to add new external tools. The file is ~/.viking/external_tools.xml. An example of the file in the distribution doc/examples/external_tools.xml. The VikWebtoolCenter allows to declare any Webtool using a logic based on center coordinates and zoom level value. The related properties are:
label
url
label
url
Routing engine. It is possible to declare new routing engines. The file is ~/.viking/routing.xml. An example of the file in the distribution doc/examples/routing.xml. The VikRoutingWebEngine allows to declare a routing engine available via HTTP. The related properties are:
id
label
format
Use gpsbabel --help on the command line to find out the supported file types and their codes to process them.
url-base
url-start-ll
url-stop-ll
url-via-ll (optional)
url-start-dir (optional)
url-stop-dir (optional)
url-ll-lat-first (optional)
For instance using Brouter services, the URL uses a pair of values which is longitude and then latitude. Thus setting this value to FALSE ensures the value substitution is performed in the necessary order.
referer (optional)
follow-location (optional)
Remote File Datasources. It is possible to add web references expected to return a file which can then be opened directly or converted via GPSBabel. The file is ~/.viking/datasources.xml. An example of the file is in the source distribution doc/examples/datasources.xml. The VikWebtoolDatasource allows to declare any URL using logic based on coordinates. The related properties are:
label
url
The order and meaning of these parameters is given by the url_format_code below
url_format_code
B = Bottom of the current view i.e. minimum latitude
L = Left of the current view i.e. minimum longitude
T = Top of the current view i.e. maximum latitude
R = Right of the current view i.e. maximum longitude
A = center lAtitude of the current view
O = center lOngitude of the current view
Z = OSM Zoom value of the current view. See Zoom Levels[1]
S = A user specified input string requested from the user via a dialog box
Thus for the url example above then the format code should be AO
file_type
If it is not defined then the returned file is interpreted internally as a GPX file.
Possible values such as 'kml', 'mapsource' etc.. can be used. See GPSBabel File Formats[3] for the full list.
babel_filter_args
E.g. "-x nuketypes,routes" can be used to filter all routes from the results.
input_label
It is the label of the text input box.
FILES¶
~/.viking/maps.xml
See previous section for details.
~/.viking/goto_tools.xml
See previous section for details.
~/.viking/external_tools.xml
See previous section for details.
~/.viking/datasources.xml
See previous section for details.
~/.viking/routing.xml
See previous section for details.
~/.viking/viking.prefs
~/.viking/viking_layer_defaults.ini
~/.viking/viking.ini
Not generally intended to be manually edited.
However some finer control of default internal values can be set.
~/.viking/keys.rc
This is in the standard GTK Accelerator map format.
~/.viking-maps/
Extension files (maps.xml, goto_tools.xml, datasources.xml, external_tools.xml, routing.xml) are also searched in /etc/viking and /usr/share/viking directories (or related in your system).
ENVIRONMENT¶
XDG_DATA_HOME
XDG_DATA_DIRS
AUTHOR¶
This manual page was originally written by Ralf Meyer <ranfyy@gmail.com> for the Debian(TM) system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
COPYRIGHT¶
Copyright © 2007 Ralf Meyer
Copyright © 2010 Guilhem Bonnefille
Copyright © 2013 Rob Norris
NOTES¶
- 1.
- Zoom Levels
- 2.
- ETag
- 3.
- GPSBabel File Formats
2021-01-11 | Viking |