Skip to content

osm2pgsql-expire.md

Latest commit

 

History

History
111 lines (77 loc) · 3.13 KB

osm2pgsql-expire.md

File metadata and controls

111 lines (77 loc) · 3.13 KB

NAME

osm2pgsql-expire - Visualize expire output

SYNOPSIS

osm2pgsql-expire [OPTIONS] OSM-FILE (1) osm2pgsql-expire [OPTIONS] OSM-FILE (1) osm2pgsql-expire TILES-FILE (2)

DESCRIPTION

The expire command can be used for two things:

  1. To check what tiles some OSM data is in. If an OSM-FILE is specified that file is read and the tiles calculated in which the objects in that file are. Note that the file must not be a change file but a regular OSM data file!
  2. Visualize tile list. If a TILE-FILE (presumably generated by osm2pgsql) is specified, a GeoJSON file is generated showing all mentioned tiles. In this mode all command line options are ignored.

Read the Expire chapter of the osm2pgsql manual (https://osm2pgsql.org/doc/manual.html#expire) for details on how to interpret the -m, \--mode and \--full-area-limit options.

OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (--). Mandatory arguments to long options are mandatory for short options too.

MAIN OPTIONS

-b, --buffer=VALUE : Set buffer size around geometry relative to tile size.

-f, --format=FORMAT : Output format. Options are 'tiles' (default) or 'geojson'. The GeoJSON output uses the Web Mercator projection (EPSG:3857) which is supported by many programs although, strictly speaking, it is not allowed by the GeoJSON spec.

--full-area-limit=VALUE : Set full area limit.

-m, --mode=MODE : Set expire mode. One of boundary_only, full_area (default), and hybrid.

-z, --zoom=ZOOM : Zoom level on which to calculate tiles.

HELP/VERSION OPTIONS

-h, --help : Print help.

-V, --version : Print osm2pgsql version.

LOGGING OPTIONS

--log-level=LEVEL : Set log level ('debug', 'info' (default), 'warn', or 'error').

--log-progress=VALUE : Enable (true) or disable (false) progress logging. Setting this to auto will enable progress logging on the console and disable it if the output is redirected to a file. Default: true.

--log-sql : Enable logging of SQL commands for debugging.

--log-sql-data : Enable logging of all data added to the database. This will write out a huge amount of data! For debugging.

-v, --verbose : Same as --log-level=debug.

DATABASE OPTIONS

-d, --database=NAME : The name of the PostgreSQL database to connect to. If this parameter contains an = sign or starts with a valid URI prefix (postgresql:// or postgres://), it is treated as a conninfo string. See the PostgreSQL manual for details.

-U, --username=NAME, --user=NAME : Postgresql user name.

-W, --password : Force password prompt.

-H, --host=HOSTNAME : Database server hostname or unix domain socket location.

-P, --port=PORT : Database server port.

--schema=SCHEMA : Default for various schema settings throughout osm2pgsql (default: public). The schema must exist in the database and be writable by the database user.

SEE ALSO