1OSMUPDATE(1) General Commands Manual OSMUPDATE(1)
2
6 osmupdate - Update OSM files
7
9 osmupdate options [oldfile] [newfile]
10
12 This program cares about updating an .osm, .o5m or .pbf file. It will
13 download and apply OSM Change files (.osc) from the servers of
14 "planet.openstreetmap.org". It also can assemble a new .osc or .o5c
15 file which can be used to update your OSM data file at a later time.
16 Prequesites
18 To run this program, please download and install two other programs
20 first: "osmconvert" and "wget".
21 Usage
23 Two command line arguments are mandatory: the name of the old and the
25 name of the new OSM data file. If the old data file does not have a
26 file timestamp, you may want to specify this timestamp manually on the
27 command line. If you do not, the program will try to determine the
28 timestamp by examining the whole old data file. Instead of the second
29 parameter, you alternatively may specify the name of a change file
30 (.osc or .o5c). In this case, you also may replace the name of the old
31 OSM data file by a timestamp. Command line arguments which are not
32 recognized by osmupdate will be passed to osmconvert. Use this opportu‐
33 nity to supply a bounding box or a bounding polygon if you are going to
34 update a regional change file. You also may exclude unneeded meta data
35 from your file by specifying this osmconvert option: --drop-author
36
38 The program osmupdate recognizes a few command line options:
39 --max-days=UPDATE_RANGE
41 By default, the maximum time range for to assemble a cumulated
43 changefile is 250 days. You can change this by giving a differ‐
44 ent maximum number of days, for example 300. If you do, please
45 ensure that there are daily change files available for such a
46 wide range of time.
47 --minute --hour --day --sporadic
49 By default, osmupdate uses a combination of minutely, hourly and
51 daily changefiles. If you want to limit these changefile cate‐
52 gories, use one or two of these options and choose that cate‐
53 gory/ies you want to be used. The option --sporadic allows pro‐
54 cessing changefile sources which do not have the usual "minute",
55 "hour" and "day" subdirectories.
56 --max-merge=COUNT
58 The subprogram osmconvert is able to merge more than two change‐
60 files in one run. This ability increases merging speed. Unfor‐
61 tunately, every changefile consumes about 200 MB of main memory
62 while being processed. For this reason, the number of parallelly
63 processable changefiles is limited. Use this commandline argu‐
64 ment to determine the maximum number of parallelly processed
65 changefiles. The default value is 7.
66 -t=TEMPPATH --tempfiles=TEMPPATH
68 On order to cache changefiles, osmupdate needs a separate direc‐
70 tory. This parameter defines the name of this directory, includ‐
71 ing the prefix of the tempfiles' names. The default value is
72 "osmupdate_temp/temp".
73 --keep-tempfiles
75 Use this option if you want to keep local copies of every down‐
77 loaded file. This is strongly recommended if you are going to
78 assemble different changefiles which overlap in time ranges.
79 Your data traffic will be minimized. Do not invoke this option
80 if you are going to use different change file sources (option
81 --base-url). This would cause severe data corruption.
82 --trust-tempfiles
84 Use this option if you want to use the saved local copies of
86 already downloaded changefiles without checking their lengths
87 against to their server-hosted originals. Downloads will be
88 limited to files not saved yet. Do not invoke this option if
89 you suspect incomplete downloads.
90 --compression-level=LEVEL
92 Define level for gzip compression. Values between 1 (low com‐
94 pression, but fast) and 9 (high compression, but slow).
95 --base-url=BASE_URL
97 To accelerate downloads or to get regional file updates you may
99 specify an alternative download location. Please enter its URL,
100 or simply the word "mirror" if you want to use gwdg's planet
101 server.
102 --base-url-suffix=BASE_URL_SUFFIX
104 To use old planet URLs, you may need to add the suffix "-repli‐
106 cate" because it was custom to have this word in the URL, right
107 after the period identifier "day" etc.
108 -v --verbose
110 With activated 'verbose' mode, some statistical data and diagno‐
112 sis data will be displayed. If -v resp. --verbose is the first
113 parameter in the line, osmupdate will display all input parame‐
114 ters.
115
117 This program is for experimental use. Expect malfunctions and data
118 loss. Do not use the program in productive or commercial systems.
119 There is NO WARRANTY, to the extent permitted by law. Please send any
121 bug reports to marqqs@gmx.eu
122
124 osmupdate old_file.o5m new_file.o5m
125 osmupdate old_file.pbf new_file.pbf
126 osmupdate old_file.osm new_file.osm
127 The old OSM data will be updated and written as new_file.o5m or
129 new_file.o5m. For safety reasons osmupdate will not delete the
130 old file. If you do not need it as backup file, please delete it
131 by yourself.
132 osmupdate old_file.osm 2011-07-15T23:30:00Z new_file.osm
134 osmupdate old_file.osm NOW-86400 new_file.osm
135 If your old OSM data file does not contain a file timestamp, or
137 you do not want to rely on this timestamp, it can be specified
138 manually. Relative times are in seconds to NOW.
139 osmupdate old_file.o5m change_file.o5c
141 osmupdate old_file.osm change_file.osc
142 osmupdate 2011-07-15T23:30:00Z change_file.o5c
143 osmupdate 2011-07-15T23:30:00Z change_file.osc.gz
144 osmupdate NOW-3600 change_file.osc.gz
145 Here, the old OSM data file is not updated directly. An OSM
147 changefile is written instead. This changefile can be used to
148 update the OSM data file afterwards. You will have recognized
149 the extension .gz in the last example. In this case, the OSM
150 Change file will be written with gzip compression. To accomplish
151 this, you need to have the program gzip installed on your sys‐
152 tem.
153 ./osmupdate london_old.o5m london_new.o5m -B=london.poly
155 The OSM data file london_old.o5m will be updated. Hence the
157 downloaded OSM changefiles contain not only London, but the
158 whole planet, a lot of unneeded data will be added to this
159 regional file. The -B= argument will clip these superfluous
160 data.
161
163 osmconvert(1), osmfilter(1)
164
166 osmconvert was written by Markus Weber
167 September 2013 OSMUPDATE(1)