Utility to warm up your tile server's cache
Last updated 2 months ago by conorpai .
Apache License v2.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @conorpai/tilemantle 
SYNC missed versions from official npm registry.


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.

$ npm install tilemantle -g
$ tilemantle -h

Usage: tilemantle <url> [<url> ...] [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
  -s, --srstype      SpatialReference Type. Default is Geographic Coordinate System, 1 is Web Mercator


# 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


Before submitting pull requests, please update the tests and make sure they all pass.

$ npm test


Copyright © 2015 Brian Reavis & 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.

Current Tags

  • 1.3.6                                ...           latest (2 months ago)

7 Versions

  • 1.3.6                                ...           2 months ago
  • 1.3.5                                ...           a year ago
  • 1.3.4                                ...           a year ago
  • 1.3.3                                ...           a year ago
  • 1.3.2                                ...           2 years ago
  • 1.3.1                                ...           2 years ago
  • 1.3.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 9
Dependencies (11)
Dev Dependencies (2)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |