|
1 | | -.TH "OSM2PGSQL" "1" "2.2.0" "" "" |
| 1 | +.TH "OSM2PGSQL" "1" "2.3.0" "" "" |
2 | 2 | .SH NAME |
3 | | -.PP |
4 | | -osm2pgsql-expire - Visualize expire output |
| 3 | +osm2pgsql\-expire \- Visualize expire output |
5 | 4 | .SH SYNOPSIS |
6 | | -.PP |
7 | | -\f[B]osm2pgsql-expire\f[R] [\f[I]OPTIONS\f[R]] \f[I]OSM-FILE\f[R] (1) |
8 | | -\f[B]osm2pgsql-expire\f[R] \f[I]TILES-FILE\f[R] (2) |
| 5 | +\f[B]osm2pgsql\-expire\f[R] [\f[I]OPTIONS\f[R]] \f[I]OSM\-FILE\f[R] (1) |
| 6 | +\f[B]osm2pgsql\-expire\f[R] \f[I]TILES\-FILE\f[R] (2) |
9 | 7 | .SH DESCRIPTION |
10 | | -.PP |
11 | 8 | \f[B]This command is currently experimental.\f[R] |
12 | 9 | .PP |
13 | 10 | The expire command can be used for two things: |
14 | 11 | .IP "1." 3 |
15 | 12 | \f[B]To check what tiles some OSM data is in.\f[R] If an |
16 | | -\f[I]OSM-FILE\f[R] is specified osm2pgsql-expire will calculate the |
| 13 | +\f[I]OSM\-FILE\f[R] is specified osm2pgsql\-expire will calculate the |
17 | 14 | tiles covering the objects in that file. |
18 | 15 | Note that the file must not be a change file but a regular OSM data |
19 | 16 | file! |
20 | 17 | Output is, by default, a tile file, but GeoJSON is also possible. |
21 | 18 | Covering tiles are only calculated for tagged objects. |
22 | 19 | .IP "2." 3 |
23 | | -\f[B]Visualize tile list.\f[R] If a \f[I]TILE-FILE\f[R] (presumably |
| 20 | +\f[B]Visualize tile list.\f[R] If a \f[I]TILE\-FILE\f[R] (presumably |
24 | 21 | generated by osm2pgsql) is specified, a GeoJSON file is generated |
25 | 22 | showing all mentioned tiles. |
26 | 23 | In this mode all command line options are ignored. |
27 | 24 | .PP |
28 | 25 | Read the \f[I]Expire\f[R] chapter of the osm2pgsql manual |
29 | 26 | (https://osm2pgsql.org/doc/manual.html#expire) for details on how to |
30 | | -interpret the \f[V]-m, \[rs]--mode\f[R] and |
31 | | -\f[V]\[rs]--full-area-limit\f[R] options. |
| 27 | +interpret the \f[CR]\-m, \[rs]\-\-mode\f[R] and |
| 28 | +\f[CR]\[rs]\-\-full\-area\-limit\f[R] options. |
32 | 29 | .SH GEOMETRY GENERATION |
33 | | -.PP |
34 | 30 | To calculate the tiles covering the specified OSM data in mode (1), a |
35 | 31 | geometry has to be generated first for each object. |
36 | 32 | This works as follow: |
37 | 33 | .IP \[bu] 2 |
38 | 34 | For nodes a point geometry will be generated. |
39 | 35 | .IP \[bu] 2 |
40 | | -For closed ways a polygon geometry will be generated, for non-closed |
| 36 | +For closed ways a polygon geometry will be generated, for non\-closed |
41 | 37 | ways a linestring geometry. |
42 | 38 | If a generated polygon is not valid, the program will fall back to a |
43 | 39 | linestring. |
44 | 40 | If neither a valid polygon nor a valid linestring can be generated the |
45 | 41 | object is ignored. |
46 | 42 | .IP \[bu] 2 |
47 | | -For relations a geometry is generated based on the \f[V]type\f[R] tag. |
48 | | -For types \f[V]multipolygon\f[R] and \f[V]boundary\f[R], a multipolygon |
49 | | -geometry is created, for types \f[V]route\f[R] and |
50 | | -\f[V]multilinestring\f[R] a multilinestring geometry is created, for all |
51 | | -other types a geometry collection is created. |
| 43 | +For relations a geometry is generated based on the \f[CR]type\f[R] tag. |
| 44 | +For types \f[CR]multipolygon\f[R] and \f[CR]boundary\f[R], a |
| 45 | +multipolygon geometry is created, for types \f[CR]route\f[R] and |
| 46 | +\f[CR]multilinestring\f[R] a multilinestring geometry is created, for |
| 47 | +all other types a geometry collection is created. |
52 | 48 | .PP |
53 | 49 | Note that for (multi)polygons it depends on the command line options |
54 | | ---mode and --full-area-limit whether the tiles calculation is based on |
55 | | -the area or the boundary of the (multi)polygons. |
| 50 | +\-\-mode and \-\-full\-area\-limit whether the tiles calculation is |
| 51 | +based on the area or the boundary of the (multi)polygons. |
56 | 52 | .SH OPTIONS |
57 | | -.PP |
58 | 53 | This program follows the usual GNU command line syntax, with long |
59 | | -options starting with two dashes (\f[V]--\f[R]). |
| 54 | +options starting with two dashes (\f[CR]\-\-\f[R]). |
60 | 55 | Mandatory arguments to long options are mandatory for short options too. |
61 | 56 | .SH MAIN OPTIONS |
62 | 57 | .TP |
63 | | --b, --buffer=VALUE |
| 58 | +\-b, \-\-buffer=VALUE |
64 | 59 | Set buffer size around geometry relative to tile size. |
65 | 60 | Example: Set to 0.1 for a buffer that\[cq]s 10% of the tile size. |
66 | 61 | .TP |
67 | | --f, --format=FORMAT |
| 62 | +\-f, \-\-format=FORMAT |
68 | 63 | Output format. |
69 | 64 | Options are `tiles' (default) or `geojson'. |
70 | 65 | The GeoJSON output uses the Web Mercator projection (EPSG:3857) which is |
71 | 66 | supported by many programs although, strictly speaking, it is not |
72 | 67 | allowed by the GeoJSON spec. |
73 | 68 | .TP |
74 | | ---full-area-limit=VALUE |
| 69 | +\-\-full\-area\-limit=VALUE |
75 | 70 | Set full area limit. |
76 | 71 | .TP |
77 | | --m, --mode=MODE |
| 72 | +\-m, \-\-mode=MODE |
78 | 73 | Set expire mode. |
79 | | -One of \f[V]boundary_only\f[R], \f[V]full_area\f[R] (default), and |
80 | | -\f[V]hybrid\f[R]. |
| 74 | +One of \f[CR]boundary_only\f[R], \f[CR]full_area\f[R] (default), and |
| 75 | +\f[CR]hybrid\f[R]. |
81 | 76 | .TP |
82 | | --z, --zoom=ZOOM |
| 77 | +\-z, \-\-zoom=ZOOM |
83 | 78 | Zoom level on which to calculate tiles. |
84 | 79 | .SH HELP/VERSION OPTIONS |
85 | 80 | .TP |
86 | | --h, --help |
| 81 | +\-h, \-\-help |
87 | 82 | Print help. |
88 | 83 | .TP |
89 | | --V, --version |
| 84 | +\-V, \-\-version |
90 | 85 | Print osm2pgsql version. |
91 | 86 | .SH LOGGING OPTIONS |
92 | 87 | .TP |
93 | | ---log-level=LEVEL |
| 88 | +\-\-log\-level=LEVEL |
94 | 89 | Set log level (`debug', `info' (default), `warn', or `error'). |
95 | 90 | .SH SEE ALSO |
96 | 91 | .IP \[bu] 2 |
97 | | -osm2pgsql website (https://osm2pgsql.org) |
| 92 | +\c |
| 93 | +.UR https://osm2pgsql.org |
| 94 | +osm2pgsql website |
| 95 | +.UE \c |
98 | 96 | .IP \[bu] 2 |
99 | | -osm2pgsql manual (https://osm2pgsql.org/doc/manual.html) |
| 97 | +\c |
| 98 | +.UR https://osm2pgsql.org/doc/manual.html |
| 99 | +osm2pgsql manual |
| 100 | +.UE \c |
100 | 101 | .IP \[bu] 2 |
101 | 102 | \f[B]osm2pgsql\f[R](1) |
102 | 103 | .IP \[bu] 2 |
|
0 commit comments