@performant-software/geospatial 3.1.22-beta.3 → 3.1.22-beta.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@performant-software/geospatial",
-  "version": "3.1.22-beta.3",
+  "version": "3.1.22-beta.4",
   "description": "A package of components for all things map-related.",
   "license": "MIT",
   "main": "./dist/index.cjs.js",

package/src/utils/Map.js

@@ -4,9 +4,15 @@ import { WarpedMapLayer } from '@allmaps/maplibre';
 import {
   bbox,
   bboxPolygon,
+  bearing,
+  bezierSpline,
   buffer,
+  destination,
+  distance,
   feature,
-  featureCollection
+  featureCollection,
+  lineString,
+  midpoint
 } from '@turf/turf';
 import _ from 'underscore';
 import circle from '@turf/circle';
@@ -202,11 +208,49 @@ const validateCoordinates = (coordinates) => {
   return valid;
 };
 
+/**
+ * Returns a GeoJSON FeatureCollection of LineStrings (arcs) for the passed coordinates.
+ *
+ * @param coordinates
+ * @param options
+ *
+ * @returns {FeatureCollection<LineString, GeoJsonProperties>}
+ */
+const toArcs = (coordinates, options = {}) => {
+  const { curvature = 0.2 } = options;
+  const features = [];
+
+  for (let i = 0; i < coordinates.length - 1; i += 1) {
+    const start = coordinates[i];
+    const end = coordinates[i + 1];
+
+    const d = distance(start, end);
+    const m = midpoint(start, end);
+    const b = bearing(start, end);
+
+    const offsetBearing = b + 90 > 180 ? b + 90 - 360 : b + 90;
+    const dest = destination(m, d * curvature, offsetBearing);
+
+    const line = lineString([start, dest.geometry.coordinates, end]);
+    const arc = bezierSpline(line);
+
+    arc.properties = {
+      ...arc.properties,
+      index: i
+    };
+
+    features.push(arc);
+  }
+
+  return featureCollection(features);
+};
+
 export default {
   addGeoreferenceLayer,
   toCertaintyCircle,
   getBoundingBox,
   removeLayer,
+  toArcs,
   toFeature,
   toFeatureCollection,
   validateBoundingBox,

package/types/utils/Map.js.flow

@@ -4,9 +4,15 @@ import { WarpedMapLayer } from '@allmaps/maplibre';
 import {
   bbox,
   bboxPolygon,
+  bearing,
+  bezierSpline,
   buffer,
+  destination,
+  distance,
   feature,
-  featureCollection
+  featureCollection,
+  lineString,
+  midpoint
 } from '@turf/turf';
 import _ from 'underscore';
 import circle from '@turf/circle';
@@ -202,11 +208,49 @@ const validateCoordinates = (coordinates) => {
   return valid;
 };
 
+/**
+ * Returns a GeoJSON FeatureCollection of LineStrings (arcs) for the passed coordinates.
+ *
+ * @param coordinates
+ * @param options
+ *
+ * @returns {FeatureCollection<LineString, GeoJsonProperties>}
+ */
+const toArcs = (coordinates, options = {}) => {
+  const { curvature = 0.2 } = options;
+  const features = [];
+
+  for (let i = 0; i < coordinates.length - 1; i += 1) {
+    const start = coordinates[i];
+    const end = coordinates[i + 1];
+
+    const d = distance(start, end);
+    const m = midpoint(start, end);
+    const b = bearing(start, end);
+
+    const offsetBearing = b + 90 > 180 ? b + 90 - 360 : b + 90;
+    const dest = destination(m, d * curvature, offsetBearing);
+
+    const line = lineString([start, dest.geometry.coordinates, end]);
+    const arc = bezierSpline(line);
+
+    arc.properties = {
+      ...arc.properties,
+      index: i
+    };
+
+    features.push(arc);
+  }
+
+  return featureCollection(features);
+};
+
 export default {
   addGeoreferenceLayer,
   toCertaintyCircle,
   getBoundingBox,
   removeLayer,
+  toArcs,
   toFeature,
   toFeatureCollection,
   validateBoundingBox,