dotted-map

You can limit to one (or several) countries (France, Italy, UK)

Installation

Requires NodeJS ≥ 13.

npm i dotted-map

Usage

const fs = require('fs');
const DottedMap = require('dotted-map');

const map = new DottedMap({ height: 100, grid: 'diagonal' });

const svgOptions = { color: '#d6ff79', radius: 0.22 };
map.addPin({ lat: 40.73061, lng: -73.935242, svgOptions });
map.addPin({ lat: -33.865143, lng: 151.2099, svgOptions });
map.addPin({ lat: -23.533773, lng: -46.62529, svgOptions });
map.addPin({ lat: 37.773972, lng: -122.431297, svgOptions });
map.addPin({ lat: 52.520008, lng: 13.404954, svgOptions });
map.addPin({ lat: 55.751244, lng: 37.618423, svgOptions });
map.addPin({ lat: 35.652832, lng: 139.839478, svgOptions });
map.addPin({ lat: 14.716677, lng: -17.467686, svgOptions });
map.addPin({ lat: -33.918861, lng: 18.4233, svgOptions });
map.addPin({ lat: -20.88231, lng: 55.4504, svgOptions });
map.addPin({ lat: 48.8534, lng: 2.3488, svgOptions: { color: '#fffcf2', radius: 0.4 } });

const svgMap = map.getSVG({ radius: 0.22, color: '#423B38', shape: 'circle', backgroundColor: '#020300' });

fs.writeFileSync('./map.svg', svgMap);

Note: if you use a large number of points (height or width ≥ 100), it may take a bit of time to compute the map (from 1 to 30 seconds depending on your device and number of points). This is why the result grid is cached. If you don't change the parameters of new DottedMap, the next maps will be a lot faster to generate. You can however change the pins and the SVG options.

Specs

// Create the map
const map = new DottedMap({
  height,
  width, // just specify either height or width, so the ratio of the map is correct
  countries: ['FRA'] // look into `countries.geo.json` to see which keys to use. You can also omit this parameter and the whole world will be used
  region: { lat: { min, max }, lng: { min, max } }, // if not present, it will fit the countries (and if no country is specified, the whole world)
  grid: 'vertical' | 'diagonal', // how points should be aligned
});

// Add some points/change the color of existing points
map.addPin({
  lat,
  lng,
  svgOptions: { color, radius },
  data, // whatever you want, useful if you use the method `getPoints` to get the raw points
});

// If you want to get the raw array of points
map.getPoints();
// [{ x, y, data, svgOptions }]

// Or use this method to get a string which is a SVG
map.getSVG({
  shape: 'circle' | 'hexagon', // if you use hexagon, prefer the grid `diagonal`
  backgroundColor, // background color of the map
  color, // default color of the points
  radius: 0.5, // default radius of the points
});
// <svg><circle … /><circle …></svg>

Acknowledgments

Countries are from https://github.com/johan/world.geo.json.