common-geospatial

Geospatial utilities for the Kalisio ekosystem

Overview

common-geospatial is organized around three modules:

• foundation - fundamental definitions and utilities
• operators - high-level data processing functions
• io - helpers for reading external data sources

Installation

Install with your preferred package manager:

pnpm

pnpm add @kalisio/common-geospatial

npm

npm install @kalisio/common-geospatial

yarn

yarn add @kalisio/common-geospatial

Or use it directly from a CDN:

<script type="module">
  import { validateGeoJson } from 'https://unpkg.com/@kalisio/common-geospatial/dist/index.mjs'
</script>

Usage

Imports

The package can be imported from its root entry point:

import { WGS84, validateGeoJson } from '@kalisio/common-geospatial'

For more explicit imports, each module is also exposed as a dedicated subpath:

import { WGS84, reprojectPosition } from '@kalisio/common-geospatial/foundation'
import { validateGeoJson } from '@kalisio/common-geospatial/operators'
import { ... } from '@kalisio/common-geospatial/io'

Examples

See the module documentation for detailed usage examples of all available functions.

Validating and fixing a GeoJSON

import {
  validateGeoJson,
  isGeoJsonFixable,
  fixGeoJson
} from '@kalisio/common-geospatial/operators'

const validation = validateGeoJson(geoJson)
if (!validation.valid && isGeoJsonFixable(validation)) {
  const fix = fixGeoJson(geoJson, validation)
}