Skip to content

juanpujol/geospread

Repository files navigation

GeoSpread

A library designed to filter a list of geographical points, ensuring that they are spread out from each other by a minimum distance in meters, optionally starting from a specific point. By applying the Haversine algorithm, GeoSpread prunes the input list to create a more evenly distributed set of points, suitable for various geospatial applications.

example-01

Installation

You can install GeoSpread via npm:

npm install geospread

Usage

import geospread from 'geospread';

// Example GeoJSON FeatureCollection input
const points = [
  [40.7481, -73.9956],
  [40.7479, -73.993],
  [40.7466, -73.9939],
  [40.7454, -73.9915],
  [40.7461, -73.9909]
];

const minDistance = 130;
const startPoint = [40.7454, -73.9915];
const result = geospread(points, minDistance, startPoint);

console.log(result);

// [40.7454, -73.9915], [40.7481, -73.9956], [40.7479, -73.993],[40.7466, -73.9939]

The function has 2 parameters:

  • points - an array of points in the format [latitude, longitude].
  • minDistance - the minimum distance in meters between each point
  • startPoint - an optional starting point in the format [latitude, longitude].

Credits

I'm not smart enough to have created this from scratch. This took some back and forth with ChatGPT and I'm not ashamed to admit it. 😄