go-tilepacks

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 18 Open GitHub ↗

A Go-based tile downloader that saves to deduplicated mbtiles files.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# go-tilepacks

A Go-based tile downloader that saves to deduplicated files.

## Tools

### build

```
./bin/build -h
Usage of ./bin/build:
  -bounds string
    	Comma-separated bounding box in south,west,north,east format. Defaults to the whole world. (default "-90.0,-180.0,90.0,180.0")
  -bucket string
    	(For metatile, tapalcatl2 generator) The name of the S3 bucket to request t2 archives from.
  -cpuprofile string
    	Enables CPU profiling. Saves the dump to the given path.
  -dsn string
    	Path, or DSN string, to output files.
  -ensure-gzip
    	Ensure tile data is gzipped. Only applies to XYZ tiles. (default true)
  -file-transport-root string
    	The root directory for tiles if -url-template defines a file:// URL scheme
  -generator string
    	Which tile fetcher to use. Options are xyz, metatile, tapalcatl2. (default "xyz")
  -inverted-y
    	Invert the Y-value of tiles to match the TMS (as opposed to ZXY) tile format.
  -layer-name string
    	(For metatile, tapalcatl2 generator) The layer name to use for hash building.
  -materialized-zooms string
    	(For tapalcatl2 generator) Specifies the materialized zooms for t2 archives.
  -output-mode string
    	Valid modes are: disk, mbtiles, pmtiles. (default "mbtiles")
  -path-template string
    	(For metatile, tapalcatl2 generator) The template to use for the path part of the S3 path to the t2 archive.
  -timeout int
    	HTTP client timeout for tile requests. (default 60)
  -url-template string
    	(For xyz generator) URL template to make tile requests with.
  -workers int
    	Number of tile fetch workers to use. (default 25)
  -zooms string
    	Comma-separated list of zoom levels or a '{MIN_ZOOM}-{MAX_ZOOM}' range string. (default "0,1,2,3,4,5,6,7,8,9,10")
```

## Job Creators

### HTTP

Required arguments:
* `-url-template`: template for an HTTP request per tile. Use `{z}` for zoom, `{x}` for x or column, and `{y}` for y or row.

### Metatile

Required arguments:
* `-bucket`: specify the S3 bucket to fetch from
* `-layer-name`: a string name for the layer part of the path template.
* `-path-template`: template for the path part of the request to S3. Use `{z}` for zoom, `{x}` for x or column, `{y}` for y or row, `{l}` for layer name, and `{h}` for the hash prefix (see below).

#### Hash Prefix

The "hash prefix" is used by the Tilezen tiler to spread the load of tile fetches across S3 shards. In practice, it is the first 5 characters of the MD5 sum of the evaluated template string `{zoom}/{x}/{y}.zip` (e.g. `12/242/533.zip`).

### Tapalcatl 2

## Outputters

The following tile "outputter" are supported, as defined by the `-mode` flag:

### disk

Clone tiles to a local directory. Valid `-dsn` strings must be in the form of:

```
-dsn 'root={PATH_TO_DIRECTORY_ROOT} format={TILE_FORMAT}'
```

### mbtiles

Clone tiles to a MBTiles (SQLite) database. Valid `-dsn` strings must be in the form of:

```
-dsn '{PATH_TO_MBTILES_DATABASE}'
```

### pmtiles

Clone tiles to a [PMTiles](https://docs.protomaps.com/pmtiles/) archive. PMTiles is a single-file archive format optimized for cloud storage (S3, GCS) and HTTP range requests. Valid `-dsn` strings must be a path to the output file:

```
-dsn '{PATH_TO_OUTPUT_FILE}'
```

Use `--output-format` to specify the tile format (`mvt` for vector tiles, `png`/`jpg` for raster). MVT tiles are stored gzip-compressed inside the archive. Duplicate tile content is deduplicated automatically.

go-tilepacks

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README