Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mojodna/tl
An alternate command line interface to tilelive
https://github.com/mojodna/tl
Last synced: 30 days ago
JSON representation
An alternate command line interface to tilelive
- Host: GitHub
- URL: https://github.com/mojodna/tl
- Owner: mojodna
- Created: 2014-05-28T22:59:48.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-07-10T20:44:07.000Z (over 6 years ago)
- Last Synced: 2024-11-05T03:05:19.527Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 39.1 KB
- Stars: 38
- Watchers: 7
- Forks: 12
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome-vector-tiles - tl - An alternate command line interface to tilelive (CLI Utilities)
README
# tl
A command line alternative to
[`tilelive`](https://github.com/mapbox/tilelive.js) that supports streaming
copies and static image rendering.## Installation
```bash
npm install tl
npm install mbtiles tilelive-file
# install any other tilelive modules you'd like to read/write from
```## Usage
Copy tiles from a filesystem to an MBTiles archive (assumes that
`tilelive-file` and `mbtiles` are installed):```bash
tl copy file://./tiles mbtiles://./tiles.mbtiles
```Render a [TM2](https://github.com/mapbox/tm2) style for a small area into an
MBTiles archive:```bash
npm install mbtiles tilelive-tmstyle tilelive-mapbox tilejson \
tilelive-vector@^0.13.0
tl copy
-z 6 -Z 6 -b "-124.4096 32.5343 -114.1308 42.0095" \
tmstyle://./project.tm2/ mbtiles://./tiles.mbtiles
```Copy tiles from an MBTiles archive to S3.
```bash
tl copy mbtiles://./tiles.mbtiles "s3://bucket-name/{z}/{x}/{y}.png?acl=public-read"
```## Caveats
Some tilelive providers use other providers but don't depend on them directly
(relying on `tilelive.load()`), so you may need to install (and `--require|-r`)
some modules that you're not using directly.For example, [`tilelive-tmstyle`](https://github.com/mojodna/tilelive-tmstyle)
often loads data using
[`tilelive-mapbox`](https://github.com/mojodna/tilelive-mapbox), which actually
uses [`tilejson`](https://github.com/mapbox/node-tilejson) under the hood to do
the fetching. Rendering is then done using
[`tilelive-vector`](https://github.com/mapbox/tilelive-vector) (which is
declared as a peer dependency of `tilelive-tmstyle`, so versions may not always
match up to whatever's most up-to-date).