Joometries

"Joometries make geoJSON geometry more sane for humans!"

Why?

GeoJSON was a totally rad much-needed standardization of geographical data for the purpose of universal cartographical display, and I think most of us could agree. I think we can also agree that arrays inside arrays 4+ levels deep can be very tricky to wrangle in the wild.

GeoJSON made parsing geometry a breeze for map software – but what about the humans that need to design input controls and content management systems for that geometry? It would be just lovely if any given user-generated value came in the form of (and could be stored in a database as):

const inYourDreams = [
	[
		[ 11, 22, 33 ],
		[ 11, 22, 33 ]
	]
];

...but more often than not, they'll be coming in like this:

let stringRiddledAndOneLevelFlat = [	
	[ "11", "22", "33" ],
	[ "11", "22", "33" ]
];

...or worse yet, this:

var creativeDevs = new Object({
	"who": [ "11 , 22,   33" ],
	"knows": [ "11, 22,33" ],
	"what": [ 11, 22, "33" ]
});

...or heaven forbid, these shenanigans:

const whatMostDBsLookLike = [{
	lat: 11, lng: 22, dep: 33
},{
	lat: 11, lng: 22, dep: 33
}];

Joometries are wee little classes to transmogrify a vivid range of number/string/array/mixup combos into valid geoJSON geometries. If there's one thing the average CMS excels at, it's manipulating and storing text-as-strings-as-text, so why work against the grain?

Make it more Joometrical:

const polygon = new Polygon([ 
	`2.812500,66.861082,0.0 
	 2.636719,62.593341,0.0 
	 16.523438,62.754726,0.0`,
	`-23.906250,54.572062,0.0 
	 -22.851563,52.802761,0.0 
	 -17.929688,53.852527,0.0`
]);

...and get this goodness!

[
	[
		[ 2.812500, 66.861082, 0.0 ],
		[ 2.636719, 62.593341, 0.0 ],
		[ 16.523438, 62.754726, 0.0 ]
	], [
		...allThatJazz
	]
]

Beam me up

You know the drill.

Get it

npm install joometries

Use it

Node:

var Polygon = require('joometries').Polygon;

ES6 (Babel/Browserify):

import { Polygon } from 'joometries';

Abuse it

var polygon = new Polygon(
	new MultiPoint(
		[11,22,33],'11,22,33'
	),
	[
		new Point('11,22,33'),
		'11,22,33',
		[ 11, 22, 33 ]
	],
	`11,22,33 44,55,66
	 11,22,33 44,55,66
	 11,22,33 44,55,66`
);