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&center=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