GitPedia

Wms tiles downloader

CLI for downloading map tiles from WMS server with given bbox and zoom.

From lmikolajczakยทUpdated May 12, 2026ยทView on GitHubยท

Command line application for downloading map tiles from given WMS server. The project is written primarily in Go, distributed under the MIT License license, first published in 2017. Key topics include: gis, golang, mercator, spherical-coordinates, tiles.

Latest release: v0.3.2

๐ŸŒ wms-tiles-downloader

Command line application for downloading map tiles from given WMS server.

Installation

go install github.com/lmikolajczak/wms-tiles-downloader@v0.3.2

Go will automatically install it in your $GOPATH/bin directory which should be in your $PATH.

Command Line Usage

Download tiles from WMS server based on provided options.

Usage:
    wms-tiles-downloader get [flags]

Flags:
        --auth        string         Basic HTTP auth credentials separated by semicolon (username:password)
    -b, --bbox        float64Slice   Comma-separated list of bbox coords (default [])
        --concurrency int            Limit of concurrent requests to the WMS server (default 16)
        --format      string         Tile format (default "image/png")
        --height      int            Tile height (default 256)
    -h, --help                       Help for get
    -l, --layer       string         Layer name
    -o, --output      string         Output directory for downloaded tiles
        --params      stringToString Custom query string params (default [])
    -s, --style       string         Layer style
    -t, --timeout     int            HTTP request timeout (in milliseconds) (default 10000)
    -u, --url         string         WMS server url
        --version     string         WMS server version (default "1.3.0")
        --width       int            Tile width (default 256)
    -z, --zoom        ints           Comma-separated list of zooms

Examples

demo

Command above will produce following output - tree of folders with files in Z/X/Y format:

root@df62f3f34fef:/tiles# tree
.
|-- 10
|   |-- 524
|   |   |-- 336.png
|   |   `-- 337.png
|   |-- 525
|   |   |-- 336.png
|   |   `-- 337.png
|   `-- 526
|       |-- 336.png
|       `-- 337.png
|-- 11
|   |-- 1049
|   |   |-- 672.png
|   |   |-- 673.png
|   |   `-- 674.png
|   |-- 1050
|   |   |-- 672.png
|   |   |-- 673.png
|   |   `-- 674.png
|   |-- 1051
|   |   |-- 672.png
|   |   |-- 673.png
|   |   `-- 674.png
|   `-- 1052
|       |-- 672.png
|       |-- 673.png
|       `-- 674.png
...more directories...

Alternative - use as a library (pkg.go.dev)

go get github.com/lmikolajczak/wms-tiles-downloader@v0.3.2

Disclaimer

Please keep in mind terms and conditions of any tile provider (WMS server) from which you plan to download tiles.

Contributors

Showing top 2 contributors by commit count.

View all contributors on GitHub โ†’

This article is auto-generated from lmikolajczak/wms-tiles-downloader via the GitHub API.Last fetched: 6/27/2026