https://github.com/naturalatlas/tilemantle
Utility to warm up your tile server cache
https://github.com/naturalatlas/tilemantle
Last synced: 7 months ago
JSON representation
Utility to warm up your tile server cache
- Host: GitHub
- URL: https://github.com/naturalatlas/tilemantle
- Owner: naturalatlas
- License: apache-2.0
- Created: 2015-01-24T10:36:05.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2018-03-06T08:38:04.000Z (over 7 years ago)
- Last Synced: 2025-04-24T03:46:31.581Z (7 months ago)
- Language: JavaScript
- Size: 239 KB
- Stars: 36
- Watchers: 6
- Forks: 19
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-Geospatial - TileMantle - A tool to warm up your tile server cache. Give it a URL template, geometry, and list of zoom levels and it will request tiles incrementally to warm it up. (JavaScript)
- awesome-gis - TileMantle - A tool to warm up your tile server cache. Give it a URL template, geometry, and list of zoom levels and it will request tiles incrementally to warm it up. (Geospatial Library / JavaScript)
README
# TileMantle
*A tool to warm up your tile server cache.* Give it a URL template, geometry, and
list of zoom levels and it will request tiles incrementally to warm it up.
```sh
$ npm install tilemantle -g
```
```
$ tilemantle -h
Usage: tilemantle [ ...] [options]
Options:
--version Display version number
-h, --help Display usage information
-l, --list Don't perform any requests, just list all tile URLs
-z, --zoom Zoom levels (comma separated or range)
-e, --extent Extent of region in the form of: nw_lat,nw_lon,se_lat,se_lon
-p, --point Center of region (use in conjunction with -b)
-b, --buffer Buffer point/geometry by an amount. Affix units at end: mi,km
-d, --delay Delay between requests. Affix units at end: ms,s
-m, --method HTTP method to use to fetch tiles
-r, --retries Number of retries
-H, --header Set request header
-c, --concurrency Number of tiles to request simultaneously
```
### Usage
```sh
# use a point with a 12mi radius
$ tilemantle http://myhost.com/{z}/{x}/{y}.png --point=44.523333,-109.057222 --buffer=12mi -z 10-14
# use an extent (nw,se)
$ tilemantle http://myhost.com/{z}/{x}/{y}.png --extent=44.523333,-109.057222,41.145556,-104.801944 -z 10-14
# use a geojson geometry as bounds
$ cat region.geojson | tilemantle http://myhost.com/{z}/{x}/{y}.png -z 10-14
# use a geojson geometry as bounds + buffer by distance
$ cat region.geojson | tilemantle http://myhost.com/{z}/{x}/{y}.png --buffer=20mi -z 10-14
```
## Contributing
Before submitting pull requests, please update the [tests](test) and make sure they all pass.
```sh
$ npm test
```
## License
Copyright © 2015 [Brian Reavis](https://github.com/brianreavis) & [Contributors](https://github.com/naturalatlas/tilemantle/graphs/contributors)
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.