@codingspark/tiles-downloader

Tiles downloader

[!IMPORTANT] This module is ESM only.

This module allows you to download tiles from a tile server. Therefore you can use it to download tiles from OpenStreetMap, etc. for offline use or caching.

Example usage

import path from "node:path";
import { downloadTiles } from "@codingspark/tiles-downloader";

await downloadTiles(
  {
    url: "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
    zoomLevels: [14, 15, 16],
    throttleConfig: { limit: 3, interval: 1000 },
    bounds: {
      minLat: 43.5704,
      maxLat: 43.645,
      minLon: 3.8095,
      maxLon: 3.923,
    },
  },
  async ({ x, y, z, buffer }) => {
    const outputPath = path.join(
      "./map",
      z.toString(),
      x.toString(),
      `${y}.png`
    );

    console.log(`Writing tile ${z}/${x}/${y}`);

    // Using bun but use anything you want to write the buffer to a file
    Bun.write(outputPath, buffer);
  }
);