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

load

Imports tiles into a feature library from a repository.

Usage:

gol load <gol-file> [<repository-path>] [<options>]
  • You must provide either the <repository-path> argument or the --url option. If you specify both, the command will first look for tiles in <repository-path>, then download any missing tiles from the given URL.

  • If no area is defined (via --area or --bbox), all tiles that aren’t already present in this library are imported from the repository.

Options

-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.