Provided by: osmctools_0.9-4_amd64 bug

NAME

       osmupdate - Update OSM files

SYNOPSIS

       osmupdate options [oldfile] [newfile]

DESCRIPTION

       This  program  cares about updating an .osm, .o5m or .pbf file. It will download and apply
       OSM Change files (.osc) from the  servers  of  "planet.openstreetmap.org".   It  also  can
       assemble a new .osc or .o5c file which can be used to update your OSM data file at a later
       time.

       Prequesites

       To run this program, please download and install two other  programs  first:  "osmconvert"
       and "wget".

       Usage

       Two  command line arguments are mandatory: the name of the old and the name of the new OSM
       data file. If the old data file does not have a file timestamp, you may  want  to  specify
       this  timestamp  manually  on  the  command  line.  If you do not, the program will try to
       determine the timestamp by examining the whole old  data  file.   Instead  of  the  second
       parameter, you alternatively may specify the name of a change file (.osc or .o5c). In this
       case, you also may replace the name of the old OSM data file by a timestamp.  Command line
       arguments  which  are  not  recognized by osmupdate will be passed to osmconvert. Use this
       opportunity to supply a bounding box or a bounding polygon if you are going  to  update  a
       regional change file. You also may exclude unneeded meta data from your file by specifying
       this osmconvert option: --drop-author

OPTIONS

       The program osmupdate recognizes a few command line options:

       --max-days=UPDATE_RANGE

              By default, the maximum time range for to assemble a cumulated  changefile  is  250
              days. You can change this by giving a different maximum number of days, for example
              300.  If you do, please ensure that there are daily change files available for such
              a wide range of time.

       --minute --hour --day --sporadic

              By default, osmupdate uses a combination of minutely, hourly and daily changefiles.
              If you want to limit these changefile categories, use one or two of  these  options
              and  choose  that  category/ies  you want to be used.  The option --sporadic allows
              processing changefile sources which do not have  the  usual  "minute",  "hour"  and
              "day" subdirectories.

       --max-merge=COUNT

              The  subprogram  osmconvert  is able to merge more than two changefiles in one run.
              This ability increases merging speed.   Unfortunately,  every  changefile  consumes
              about  200  MB of main memory while being processed. For this reason, the number of
              parallelly processable changefiles is limited.  Use this  commandline  argument  to
              determine the maximum number of parallelly processed changefiles. The default value
              is 7.

       -t=TEMPPATH --tempfiles=TEMPPATH

              On order to cache changefiles, osmupdate needs a separate directory. This parameter
              defines  the  name of this directory, including the prefix of the tempfiles' names.
              The default value is "osmupdate_temp/temp".

       --keep-tempfiles

              Use this option if you want to keep local copies of every downloaded file. This  is
              strongly  recommended  if  you  are  going  to assemble different changefiles which
              overlap in time ranges. Your data traffic will be minimized.  Do  not  invoke  this
              option  if  you are going to use different change file sources (option --base-url).
              This would cause severe data corruption.

       --trust-tempfiles

              Use this option if you want to use the saved local  copies  of  already  downloaded
              changefiles   without   checking  their  lengths  against  to  their  server-hosted
              originals.  Downloads will be limited to files not saved yet.  Do not  invoke  this
              option if you suspect incomplete downloads.

       --compression-level=LEVEL

              Define level for gzip compression. Values between 1 (low compression, but fast) and
              9 (high compression, but slow).

       --base-url=BASE_URL

              To accelerate downloads or  to  get  regional  file  updates  you  may  specify  an
              alternative download location. Please enter its URL, or simply the word "mirror" if
              you want to use gwdg's planet server.

       --base-url-suffix=BASE_URL_SUFFIX

              To use old planet URLs, you may need to add the suffix "-replicate" because it  was
              custom to have this word in the URL, right after the period identifier "day" etc.

       -v --verbose

              With  activated  'verbose'  mode,  some statistical data and diagnosis data will be
              displayed.  If -v resp. --verbose is the first parameter  in  the  line,  osmupdate
              will display all input parameters.

NOTES

       This  program  is  for experimental use. Expect malfunctions and data loss. Do not use the
       program in productive or commercial systems.

       There is NO WARRANTY, to the extent permitted by law.  Please  send  any  bug  reports  to
       marqqs@gmx.eu

EXAMPLE

       osmupdate old_file.o5m new_file.o5m
       osmupdate old_file.pbf new_file.pbf
       osmupdate old_file.osm new_file.osm

              The  old  OSM data will be updated and written as new_file.o5m or new_file.o5m. For
              safety reasons osmupdate will not delete the old file. If you do  not  need  it  as
              backup file, please delete it by yourself.

              osmupdate old_file.osm 2011-07-15T23:30:00Z new_file.osm
              osmupdate old_file.osm NOW-86400 new_file.osm

              If  your old OSM data file does not contain a file timestamp, or you do not want to
              rely on this timestamp, it can be specified manually. Relative times are in seconds
              to NOW.

              osmupdate old_file.o5m change_file.o5c
              osmupdate old_file.osm change_file.osc
              osmupdate 2011-07-15T23:30:00Z change_file.o5c
              osmupdate 2011-07-15T23:30:00Z change_file.osc.gz
              osmupdate NOW-3600 change_file.osc.gz

              Here,  the  old OSM data file is not updated directly. An OSM changefile is written
              instead. This changefile can be used to update the OSM data file  afterwards.   You
              will  have  recognized the extension .gz in the last example. In this case, the OSM
              Change file will be written with gzip compression. To accomplish this, you need  to
              have the program gzip installed on your system.

              ./osmupdate london_old.o5m london_new.o5m -B=london.poly

              The  OSM  data  file  london_old.o5m  will  be  updated.  Hence  the downloaded OSM
              changefiles contain not only London, but the whole planet, a lot of  unneeded  data
              will  be  added to this regional file. The -B= argument will clip these superfluous
              data.

SEE ALSO

       osmconvert(1), osmfilter(1)

AUTHORS

       osmconvert was written by Markus Weber

                                          September 2013                             OSMUPDATE(1)