tile-cacher

tile-cacher 0.1.4

Node express-like middleware and downloader for map tile caches

Middleware

The middleware can be used with HTTP libraries like Express and Polka. When instantiated, if connected to the Internet, it will check the actively cached tile have been cached and remove old cached tiles. It will also schedule the next check inline with the checkInterval option.

Example

examples/middleware.js

import { createReadStream } from 'fs';
import polka from 'polka';
import middleware from 'tile-cacher';
import { options } from './options.js';
import { dirname, join } from 'path';
import { fileURLToPath } from 'url';

const __dirname = dirname(fileURLToPath(import.meta.url));

const app = polka();

app.get('/', (req, res) => {
  const stream = createReadStream(join(__dirname, 'index.html'));
  res.setHeader('Content-Type', 'text/html');
  stream.pipe(res);
});
app.get('/tiles/:id/:z/:x/:y.png', middleware(options));

app.listen(3030, () => {
  console.log('tile-cacher middleware listening on port 3030');
});

Tile Cache Check

Example

examples/cacheCheck.js

import { checkCache } from 'tile-cacher';
import { options } from './options.js';

checkCache(options);

Options

Options are the same for both the middlware and the cacheCheck functionality

Example

examples/options.js

export const options = {
  servers: [
    {
      id: 'opentopomap',
      url: 'https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png',
      activelyCache: [
        {
          northLat: -40.975513,
          southLat: -41.100311,
          westLon: 174.994183,
          eastLon: 175.148163,
          maxZoom: 13
        }
      ],
      cache: [
        {
          northLat: -39.975513,
          southLat: -42.100311,
          westLon: 173.994183,
          eastLon: 176.148163,
          maxZoom: 13
        }
      ],
      age: 168
    }
  ],
  checkInterval: 20,
  downloadWaitTime: 1000,
  extension: 'png',
  folder: 'cache',
  logger: {
    log: (...args) => console.log(new Date().toISOString(), 'LOG', ...args),
    warn: (...args) => console.warn(new Date().toISOString(), 'WARN', ...args),
    debug: (...args) => console.debug(new Date().toISOString(), 'DEBUG', ...args),
    info: (...args) => console.info(new Date().toISOString(), 'INFO', ...args),
    error: (...args) => console.error(new Date().toISOString(), 'ERROR', ...args)
  }
};

Development

Feel free to contribute to the code or documentation, or leave issues or suggestions on the issue tracker or email them to us. Please submit security concerns as a confidential issue.

The source is hosted on Gitlab and uses prettier, lint-staged and husky to keep things pretty. As such, when you first clone the repository, as well as installing the npm dependencies, you will also need to install husky.

# Install NPM dependencies
npm install
# Set up husky Git hooks stored in .husky
npx husky install

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

0.1.4 - 2023-03-19

Added

• Added logger to options typings

Fixed

• Checking for internet connectivity was throwing if not connected

0.1.3 - 2022-06-02

Added

• Server response time logging

0.1.2 - 2022-06-02

Fixed

• Middleware issue not passing through requested tile from remote server
• Changed to AGPL-3.0 license

0.1.1 - 2022-06-02

Fixed

• Fixed example code in README

0.1.0 - 2022-06-02

Added

• Basic tile cache downloading
• Basic middleware