Skip to main content Link Search Menu Expand Document (external link)

copy 0.3

Copies tiles from one library to another.


gol copy <source-gol-file> <target-gol-file> [<options>]
  • If an area is specified (using --bbox or --area, only the tiles touching that area are copied.

  • Missing tiles will be imported from a repository, if one is specified via --url.

  • To create a backup, or to share a library via a network connection or slow/space-restricted media, use save.

  • If the source and target GOL contain different versions, the target’s version is set to the newer version, and all tiles from the older GOL are marked as stale.


-a, --area=<FILE>

Defines the area to which the command should be applied. Currently, only polygon files are supported.

-b, --bbox=<W>,<S>,<E>,<N>

Defines the rectangular area (bounding box) to which the command should be applied. Coordinates are specified in WGS-84 (degrees longitude and latitude) and take the form <west>,<south>,<east>,<north>. Coordinates must not be separated by spaces (otherwise, they would be interpreted as separate arguments).

As an alternative, this option accepts a tile descriptor in the form z/x/y.

-n, --new

Use this option to create an empty .gol file if the specified library does not exist (rather than failing with an error message). Combine this option with --url to specify a tile repository from which the library will be populated.

-q, --quiet

Displays only minimal output. Apart from error messages, only minimal progress updates are written to stderr.

-s, --silent

No output at all is written to stderr, not even error messages. (Whether a command succeeded or failed can only be ascertained via the status code returned by the process).

-u, --url=<URL>

Specifies the URL of the remote repository from which tiles are downloaded into the library.

-v, --verbose

Writes extra information to stderr.