NAME
gpsfetchmap - Download maps from a mapserver.
DESCRIPTION
gpsfetchmap is a program to download maps from a mapserver for use with
gpsdrive.
SYNOPSIS
Common usages:
gpsfetchmap -w <WAYPOINT NAME> -sc <SCALE> -a <#> -p
gpsfetchmap -la <latitude MM.DDDD> -lo <latitude MM.DDDD> -sc <SCALE>
-a <#> -p
gpsfetchmap -sla <start latitude MM.DDDD> -endla <end latitude MM.DDDD>
-slo <start longitude MM.DDDD> -endlo <end longitude MM.DDDD> -sc
<SCALE> -a <#> -p
gpsfetchmap -sc <SCALE> -a <#> -r <WAYPOINT 1> <WAYPOINT 2> ...
<WAYPOINT n> -p
All options:
gpsfetchmap [-w <WAYPOINT NAME>]
[-la <latitude DD.MMMM>] [-lo <longitude DD.MMMM>]
[-sla <start latitude DD.MMMM>] [-endla <end latitude
DD.MMMM>]
[-slo <start longitude DD.MMMM>] [-endlo <end longitude
DD.MMMM>]
[-sc <SCALE>] [-a <#>] [-p] [-m <MAPSERVER>]
[-u <UNIT>] [-md <DIR>] [-W <FILE>] [-t <FILE>] [-r]
[-C <FILE>] [-P <PREFIX>] [-F] [-d] [-v] [-h] [-M] [-n]
[-U] [-c]
OPTIONS
-w, --waypoint <WAYPOINT NAME>
Takes a waypoint name and uses the latitude and longitude for
that waypoint as the centerpoint of the area to be covered.
Waypoints are read from 'way.txt', or file defined by '-W'.
the special name gpsd asks your local gpsd where your gps
thinks you are and uses this point as center. This, '-la' and
'-lo', '-sla', '-ela', '-slo' and '-elo' or '-a' is required.
A special name is gpsd this waypoint asks your gps where you
currently are.
-la, --lat <latitude DD.MMMM>
Takes a latitude in format DD.MMMM and uses that as the
latitude for the centerpoint of the area to be covered. Will be
overriden by the latitude of waypoint if '-w' is used. This and
'-lo', '-w' or '-sla', '-ela', '-slo', '-elo' is required.
-lo, --lon <longitude DD.MMMM>
Takes a longitude in format DD.MMMM and uses that as the
longitude for the centerpoint of the area to be covered. Will
be overriden by the longitude of waypoint if '-w' is used. This
and '-la', '-w' or '-sla', '-ela', '-slo', '-elo' is required.
-sla --start-lat <start latitude DD.MMMM>
Takes a latitude in format DD.MMMM and uses that as the start
latitude for the area to be covered. Will override '-la' and
'-lo' but will be overriden by '-w'. This, '-ela', '-slo' and
'-elo' or '-w' or '-la' and '-lo' is required.
-ela --end-lat <end latitude DD.MMMM>
Takes a latitude in format DD.MMMM and uses that as the end
latitude for the area to be covered. Will override '-la' and
'-lo' but will be overriden by '-w'. This, '-sla', '-slo' and
'-elo' or '-w' or '-la' and '-lo' is required.
-slo --start-lon <start longitude DD.MMMM>
Takes a longitude in format DD.MMMM and uses that as the start
longitude for the area to be covered. Will override '-la' and
'-lo' but will be overriden by '-w'. This, '-sla', '-ela' and
'-elo' or '-w' or '-la' and '-lo' is required.
-elo --end-lon <end longitude DD.MMMM>
Takes a longitude in format DD.MMMM and uses that as the end
longitude for the area to be covered. Will override '-la' and
'-lo' but will be overriden by '-w'. This, '-sla', '-ela' and
'-slo' or '-w' or '-la' and '-lo' is required.
-sc, --scale <SCALE>
Scales of map(s) to download. Default: 50000.
Formats:
'####'
- Just this scale.
'####,####,####'
- All scales in the list. May be combined with other formats.
'>####'
- All scales above and including the number given.
'<####'
- All scales below and including the number given.
'####-####'
- All scales from first to last number given.
-a, --area <#>
Area to cover. # of 'units' size square around the centerpoint.
You can use a single number for square area. Or you can use
'#x#' to do a rectangle, where the first number is distance
latitude and the second number is distance of longitude.
'units' is read from the configuration file (-C) or as defined
by (-u).
-p, --polite
This causes the program to sleep one second between downloads
to be polite to the mapserver. Takes an optional value of
number of seconds to sleep.
--mapserver <MAPSERVER>
Mapserver to download from. Default: 'landsat'. Currently can
use: landsat
geoscience, gov_au, incrementp and eniro have download stubs,
but they are !!!NOT!!!! in the right scale.
geoscience
landsat covers the whole world with satelite Photos
gov_au is for Australia
incrementp for japanese Maps
eniro covers:
eniro_se Sweden
eniro_dk Denmark
eniro_no Norway
eniro_fi Finnland
Overview of Area covered by eniro_fi:
http://maps.eniro.com/servlets/fi_MapImageLocator?profile=Main¢er=26.;62.&zoomlevel=1&size=800x600
-u, --unit <UNIT>
The measurement system to use. Default is read from
configuration file <-C>. Possibles are: miles, nautical,
kilometers.
--mapdir <DIR>
Override the configfiles mapdir with this value.
-W, --WAYPOINT <FILE>
File to read waypoints from. Default: '~/.gpsdrive/way.txt'.
-t, --track <FILE>
Download maps that are along a saved track. File is a standard
track filed saved from GpsDrive.
-r, --route
Download maps that are along a route defined by waypoints. You
must give a list of waypoints as parameters separated with
space.
-C, --CONFIG
File to read for GPSDrive configuration information. Default:
'~/.gpsdrive/gpsdriverc'.
-P, --PREFIX <PREFIX>
Takes a prefix string to be used as the start of all saved map
files. Default: "map_".
-F, --FORCE
Force program to download maps without asking you to confirm
the download.
-n Dont download anything only tell which maps are missing
-U read map_koord.txt file at Start. Then also check for not
downloaded map_*.gif Files if they need to be appended to
map_koords.txt.
--check-koordfile
Update map_koord.txt: search map Tree if map_*.gif file exist,
but cannot be found in map_koords.txt file. This option first
reads the map_koord.txt file and checks every Map in the
filesystem if it also is found in the map_koord.txt file. If
not found it is appended into the map_koord.txt file.
Check map_koord.txt File. This option checks, if every Map also
exist If any Map-File is missing, a file map_koord.txt.new will
be created. This file can be copied to the original file if
checked.
--check-coverage
See which areas the maps cover. Output is simple ASCII Art
--PROXY Set proxy for mirroring image Files
-d, --debug
Prints debugging information.
-v, --version
Prints version information and exits.
--help -h -x
Prints the usage page and exits.
--MAN -M
Prints the manual page and exits.
Download
When downloading Maps the output reads as folows:
_ Map already exists in Filesystem
E Error while downloading Map
+ Map got downloaded
u updated map_koords.txt File
S Simulate only