wkt-parser-helper

Convert and parse between Well-Known-Text (WKT) and GeoJSON

Installation

Using npm npm i wkt-parser-helper

Using yarn yarn add wkt-parser-helper

Usage

In CommonJS env

const { parseFromWK } = require('wkt-parser-helper');

const geojson = parseFromWK(
  'POLYGON ((-3.706512451171875 40.420074462890625, -3.70513916015625 40.420074462890625, -3.70513916015625 40.42144775390625, -3.706512451171875 40.42144775390625, -3.706512451171875 40.420074462890625))'
);

// geojson is a Polygon Geometry

Using imports

import { convertToWK } from 'wkt-parser-helper';

const myFeature: Feature = {
  type: 'Feature',
  properties: {},
  geometry: {
    type: 'Polygon',
    coordinates: [
      [
        [-3.706512451171875, 40.420074462890625],
        [-3.70513916015625, 40.420074462890625],
        [-3.70513916015625, 40.42144775390625],
        [-3.706512451171875, 40.42144775390625],
        [-3.706512451171875, 40.420074462890625],
      ],
    ],
  },
};

const myFeatureAsWKT = convertToWK(myFeature);

// myFeatureAsWKT is 'POLYGON ((-3.706512451171875 40.420074462890625, -3.70513916015625 40.420074462890625, -3.70513916015625 40.42144775390625, -3.706512451171875 40.42144775390625, -3.706512451171875 40.420074462890625))'

Breaking changes

From v4.0.0 onwards, support for converting GeoJSON to WKB is dropped.

Table of contents

Functions

• convertFeatureCollection
• convertFeatureToWK
• convertGeometryToWK
• convertFeatureCollectionToWktCollection
• convertToWK
• parseFromWK

Functions

convertFeatureCollection

▸ convertFeatureCollection(featureCollection: FeatureCollection): string

Converts a GeoJSON FeatureCollection to WKT GeometryCollection

export

Parameters:

Name	Type	Description
featureCollection	FeatureCollection	The FeatureCollection to convert to WKT

Returns: string

The GeoJSON converted to well known representation

---

convertFeatureToWK

▸ convertFeatureToWK(geojson: Feature): string

Converts GeoJSON Feature to WKT

export

Parameters:

Name	Type	Description
geojson	Feature	Feature object to convert

Returns: string

The GeoJSON converted to well known text representation

---

convertGeometryToWK

▸ convertGeometryToWK(geojson: Geometry): string

Converts GeoJSON Geometry to WKT

export

Parameters:

Name	Type	Description
geojson	Geometry	Geometry object to convert

Returns: string

The GeoJSON converted to well known text representation

---

convertFeatureCollectionToWktCollection

▸ convertFeatureCollectionToWktCollection<P>(geojson: FeatureCollection<Geometry, P>): P & { wkt: string }[]

Converts a GeoJSON FeatureCollection into an array of objects where each object contains a WKT (Well-Known Text) string representing the geometry and the properties from the original GeoJSON feature

Type parameters:

Name	Description
P	The type of properties in the GeoJSON features

Parameters:

Name	Type	Description
geojson	FeatureCollection<Geometry, P>	The GeoJSON FeatureCollection to be converted

Returns: P & { wkt: string }[]

)[]} An array of objects where each object contains a wkt string representing the geometry and all the properties from the original GeoJSON feature

---

convertToWK

▸ convertToWK(geojson: GeoJSON): string

Shorthand to convert GeoJSON Features, Geometries or FeatureCollections to WKT or WKB

export

Parameters:

Name	Type	Description
geojson	GeoJSON	The GeoJSON to convert

Returns: string

The GeoJSON as WKT

---

parseFromWK

▸ parseFromWK(item: string, asFeature?: boolean, properties?: GeoJsonProperties): Feature | Geometry

Parse a WKT or WKB into a GeoJSON Feature or Geometry

export

Parameters:

Name	Type	Default value	Description
item	string	-	The WKT to convert to GeoJSON
asFeature	boolean	false	-
properties	GeoJsonProperties	-	-

Returns: Feature | Geometry

The WKT as GeoJSON