NAME

       pyosmium-up-to-date - Bring OSM files up-to-date

USAGE

   pyosmium-up-to-date.py
       Update an OSM file with changes from a OSM replication server.

       Diffs  are  downloaded and kept in memory. To avoid running out of memory, the maximum size of diffs that
       can be downloaded at once is limited to 1 GB per default. This corresponds to  approximately  3  days  of
       update.   The  limit  can be changed with the –size parameter. However, you should take into account that
       processing the files requires additional memory (about 1GB more).

       The starting time is automatically determined from the data in the file.   For  PBF  files,  it  is  also
       possible  to  read  and write the replication information from the osmosis headers. That means that after
       the first update, subsequent calls to pyosmium-up-to-date will continue the updates from the same  server
       exactly where they have left of.

       The  program returns 0, if updates have been successfully applied up to the newest data. It returns 1, if
       some updates have been applied but there is still data available on the server (either because  the  size
       limit has been reached or there was a network error which could not be resolved). Any other error results
       in a return code larger than 1. The output file is guaranteed to be unmodified in that case.

       Some OSM data sources require a cookie to be sent with the HTTP requests.  Pyosmium-up-to-date  does  not
       fetch  the cookie from these services for you.  However, it can read cookies from a Netscape-style cookie
       jar file, send these cookies to the server and will save received cookies to the jar file.

          usage: pyosmium-up-to-date [options] <osm file>

       <osm file>
              OSM file to update

       -h, --help
              show this help message and exit

       -v     Increase verbosity

       -o <outfile>, --outfile <outfile>
              Name output of file. If missing, the input file will be overwritten.

       --server <server_url>
              Base URL of the replication server.  Default:  ‘https://planet.osm.org/replication/hour/’  (hourly
              diffs from osm.org).

       -s <size>, --size <size>
              Maximum size of change to apply at once in MB. Default: 1GB.

       --tmpdir <tmpdir>
              Directory to use for temporary files. Default: directory of input file

       --ignore-osmosis-headers
              Ignore potential replication information in the header of the input file and search for the newest
              OSM object in the file instead.

       -b <wind_back>, --wind-back <wind_back>
              Number of minutes to start downloading before the newest addition to input data. (Ignored when the
              file contains a sequence ID.) Default: 60.

       --force-update-of-old-planet
              Apply update even if the input data is really old.

       --cookie <cookie>
              Netscape-style cookie jar file to read cookies from and where
                                            received cookies will be written to.

AUTHOR

       Sarah Hoffmann

COPYRIGHT

       2015-2020, Sarah Hoffmann