@@ -16,7 +16,8 @@ The expire command can be used for two things:
16161 . ** To check what tiles some OSM data is in.** If an * OSM-FILE* is specified
1717 osm2pgsql-expire will calculate the tiles covering the objects in that file.
1818 Note that the file must not be a change file but a regular OSM data file!
19- Output is, by default, a tile file, but GeoJSON is also possible.
19+ Output is, by default, a tile file, but GeoJSON is also possible.Covering
20+ tiles are only calculated for tagged objects.
20212 . ** Visualize tile list.** If a * TILE-FILE* (presumably generated by osm2pgsql)
2122 is specified, a GeoJSON file is generated showing all mentioned tiles. In
2223 this mode all command line options are ignored.
@@ -25,6 +26,25 @@ Read the *Expire* chapter of the osm2pgsql manual
2526(https://osm2pgsql.org/doc/manual.html#expire ) for details on how to
2627interpret the ` -m, \--mode ` and ` \--full-area-limit ` options.
2728
29+ # GEOMETRY GENERATION
30+
31+ To calculate the tiles covering the specified OSM data in mode (1), a geometry
32+ has to be generated first for each object. This works as follow:
33+
34+ * For nodes a point geometry will be generated.
35+ * For closed ways a polygon geometry will be generated, for non-closed ways
36+ a linestring geometry. If a generated polygon is not valid, the program
37+ will fall back to a linestring. If neither a valid polygon nor a valid
38+ linestring can be generated the object is ignored.
39+ * For relations a geometry is generated based on the ` type ` tag. For types
40+ ` multipolygon ` and ` boundary ` , a multipolygon geometry is created, for types
41+ ` route ` and ` multilinestring ` a multilinestring geometry is created, for
42+ all other types a geometry collection is created.
43+
44+ Note that for (multi)polygons it depends on the command line options \- -mode
45+ and \- -full-area-limit whether the tiles calculation is based on the area or
46+ the boundary of the (multi)polygons.
47+
2848# OPTIONS
2949
3050This program follows the usual GNU command line syntax, with long options
0 commit comments