/** * @module ol/format/WKT */ import Feature from '../Feature.js'; import {transformWithOptions} from './Feature.js'; import TextFeature from './TextFeature.js'; import GeometryCollection from '../geom/GeometryCollection.js'; import GeometryType from '../geom/GeometryType.js'; import GeometryLayout from '../geom/GeometryLayout.js'; import LineString from '../geom/LineString.js'; import MultiLineString from '../geom/MultiLineString.js'; import MultiPoint from '../geom/MultiPoint.js'; import MultiPolygon from '../geom/MultiPolygon.js'; import Point from '../geom/Point.js'; import Polygon from '../geom/Polygon.js'; /** * Geometry constructors * @enum {function (new:import("../geom/Geometry.js").default, Array, GeometryLayout)} */ const GeometryConstructor = { 'POINT': Point, 'LINESTRING': LineString, 'POLYGON': Polygon, 'MULTIPOINT': MultiPoint, 'MULTILINESTRING': MultiLineString, 'MULTIPOLYGON': MultiPolygon }; /** * @typedef {Object} Options * @property {boolean} [splitCollection=false] Whether to split GeometryCollections into * multiple features on reading. */ /** * @typedef {Object} Token * @property {number} type * @property {number|string} [value] * @property {number} position */ /** * @const * @type {string} */ const EMPTY = 'EMPTY'; /** * @const * @type {string} */ const Z = 'Z'; /** * @const * @type {string} */ const M = 'M'; /** * @const * @type {string} */ const ZM = 'ZM'; /** * @const * @enum {number} */ const TokenType = { TEXT: 1, LEFT_PAREN: 2, RIGHT_PAREN: 3, NUMBER: 4, COMMA: 5, EOF: 6 }; /** * @const * @type {Object} */ const WKTGeometryType = {}; for (const type in GeometryType) { WKTGeometryType[type] = GeometryType[type].toUpperCase(); } /** * Class to tokenize a WKT string. */ class Lexer { /** * @param {string} wkt WKT string. */ constructor(wkt) { /** * @type {string} */ this.wkt = wkt; /** * @type {number} * @private */ this.index_ = -1; } /** * @param {string} c Character. * @return {boolean} Whether the character is alphabetic. * @private */ isAlpha_(c) { return c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z'; } /** * @param {string} c Character. * @param {boolean=} opt_decimal Whether the string number * contains a dot, i.e. is a decimal number. * @return {boolean} Whether the character is numeric. * @private */ isNumeric_(c, opt_decimal) { const decimal = opt_decimal !== undefined ? opt_decimal : false; return c >= '0' && c <= '9' || c == '.' && !decimal; } /** * @param {string} c Character. * @return {boolean} Whether the character is whitespace. * @private */ isWhiteSpace_(c) { return c == ' ' || c == '\t' || c == '\r' || c == '\n'; } /** * @return {string} Next string character. * @private */ nextChar_() { return this.wkt.charAt(++this.index_); } /** * Fetch and return the next token. * @return {!Token} Next string token. */ nextToken() { const c = this.nextChar_(); const position = this.index_; /** @type {number|string} */ let value = c; let type; if (c == '(') { type = TokenType.LEFT_PAREN; } else if (c == ',') { type = TokenType.COMMA; } else if (c == ')') { type = TokenType.RIGHT_PAREN; } else if (this.isNumeric_(c) || c == '-') { type = TokenType.NUMBER; value = this.readNumber_(); } else if (this.isAlpha_(c)) { type = TokenType.TEXT; value = this.readText_(); } else if (this.isWhiteSpace_(c)) { return this.nextToken(); } else if (c === '') { type = TokenType.EOF; } else { throw new Error('Unexpected character: ' + c); } return {position: position, value: value, type: type}; } /** * @return {number} Numeric token value. * @private */ readNumber_() { let c; const index = this.index_; let decimal = false; let scientificNotation = false; do { if (c == '.') { decimal = true; } else if (c == 'e' || c == 'E') { scientificNotation = true; } c = this.nextChar_(); } while ( this.isNumeric_(c, decimal) || // if we haven't detected a scientific number before, 'e' or 'E' // hint that we should continue to read !scientificNotation && (c == 'e' || c == 'E') || // once we know that we have a scientific number, both '-' and '+' // are allowed scientificNotation && (c == '-' || c == '+') ); return parseFloat(this.wkt.substring(index, this.index_--)); } /** * @return {string} String token value. * @private */ readText_() { let c; const index = this.index_; do { c = this.nextChar_(); } while (this.isAlpha_(c)); return this.wkt.substring(index, this.index_--).toUpperCase(); } } /** * Class to parse the tokens from the WKT string. */ class Parser { /** * @param {Lexer} lexer The lexer. */ constructor(lexer) { /** * @type {Lexer} * @private */ this.lexer_ = lexer; /** * @type {Token} * @private */ this.token_; /** * @type {GeometryLayout} * @private */ this.layout_ = GeometryLayout.XY; } /** * Fetch the next token form the lexer and replace the active token. * @private */ consume_() { this.token_ = this.lexer_.nextToken(); } /** * Tests if the given type matches the type of the current token. * @param {TokenType} type Token type. * @return {boolean} Whether the token matches the given type. */ isTokenType(type) { const isMatch = this.token_.type == type; return isMatch; } /** * If the given type matches the current token, consume it. * @param {TokenType} type Token type. * @return {boolean} Whether the token matches the given type. */ match(type) { const isMatch = this.isTokenType(type); if (isMatch) { this.consume_(); } return isMatch; } /** * Try to parse the tokens provided by the lexer. * @return {import("../geom/Geometry.js").default} The geometry. */ parse() { this.consume_(); const geometry = this.parseGeometry_(); return geometry; } /** * Try to parse the dimensional info. * @return {GeometryLayout} The layout. * @private */ parseGeometryLayout_() { let layout = GeometryLayout.XY; const dimToken = this.token_; if (this.isTokenType(TokenType.TEXT)) { const dimInfo = dimToken.value; if (dimInfo === Z) { layout = GeometryLayout.XYZ; } else if (dimInfo === M) { layout = GeometryLayout.XYM; } else if (dimInfo === ZM) { layout = GeometryLayout.XYZM; } if (layout !== GeometryLayout.XY) { this.consume_(); } } return layout; } /** * @return {!Array} A collection of geometries. * @private */ parseGeometryCollectionText_() { if (this.match(TokenType.LEFT_PAREN)) { const geometries = []; do { geometries.push(this.parseGeometry_()); } while (this.match(TokenType.COMMA)); if (this.match(TokenType.RIGHT_PAREN)) { return geometries; } } else if (this.isEmptyGeometry_()) { return []; } throw new Error(this.formatErrorMessage_()); } /** * @return {Array} All values in a point. * @private */ parsePointText_() { if (this.match(TokenType.LEFT_PAREN)) { const coordinates = this.parsePoint_(); if (this.match(TokenType.RIGHT_PAREN)) { return coordinates; } } else if (this.isEmptyGeometry_()) { return null; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array>} All points in a linestring. * @private */ parseLineStringText_() { if (this.match(TokenType.LEFT_PAREN)) { const coordinates = this.parsePointList_(); if (this.match(TokenType.RIGHT_PAREN)) { return coordinates; } } else if (this.isEmptyGeometry_()) { return []; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array>>} All points in a polygon. * @private */ parsePolygonText_() { if (this.match(TokenType.LEFT_PAREN)) { const coordinates = this.parseLineStringTextList_(); if (this.match(TokenType.RIGHT_PAREN)) { return coordinates; } } else if (this.isEmptyGeometry_()) { return []; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array>} All points in a multipoint. * @private */ parseMultiPointText_() { if (this.match(TokenType.LEFT_PAREN)) { let coordinates; if (this.token_.type == TokenType.LEFT_PAREN) { coordinates = this.parsePointTextList_(); } else { coordinates = this.parsePointList_(); } if (this.match(TokenType.RIGHT_PAREN)) { return coordinates; } } else if (this.isEmptyGeometry_()) { return []; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array>>} All linestring points * in a multilinestring. * @private */ parseMultiLineStringText_() { if (this.match(TokenType.LEFT_PAREN)) { const coordinates = this.parseLineStringTextList_(); if (this.match(TokenType.RIGHT_PAREN)) { return coordinates; } } else if (this.isEmptyGeometry_()) { return []; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array>>>} All polygon points in a multipolygon. * @private */ parseMultiPolygonText_() { if (this.match(TokenType.LEFT_PAREN)) { const coordinates = this.parsePolygonTextList_(); if (this.match(TokenType.RIGHT_PAREN)) { return coordinates; } } else if (this.isEmptyGeometry_()) { return []; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array} A point. * @private */ parsePoint_() { const coordinates = []; const dimensions = this.layout_.length; for (let i = 0; i < dimensions; ++i) { const token = this.token_; if (this.match(TokenType.NUMBER)) { coordinates.push(/** @type {number} */ (token.value)); } else { break; } } if (coordinates.length == dimensions) { return coordinates; } throw new Error(this.formatErrorMessage_()); } /** * @return {!Array>} An array of points. * @private */ parsePointList_() { const coordinates = [this.parsePoint_()]; while (this.match(TokenType.COMMA)) { coordinates.push(this.parsePoint_()); } return coordinates; } /** * @return {!Array>} An array of points. * @private */ parsePointTextList_() { const coordinates = [this.parsePointText_()]; while (this.match(TokenType.COMMA)) { coordinates.push(this.parsePointText_()); } return coordinates; } /** * @return {!Array>>} An array of points. * @private */ parseLineStringTextList_() { const coordinates = [this.parseLineStringText_()]; while (this.match(TokenType.COMMA)) { coordinates.push(this.parseLineStringText_()); } return coordinates; } /** * @return {!Array>>>} An array of points. * @private */ parsePolygonTextList_() { const coordinates = [this.parsePolygonText_()]; while (this.match(TokenType.COMMA)) { coordinates.push(this.parsePolygonText_()); } return coordinates; } /** * @return {boolean} Whether the token implies an empty geometry. * @private */ isEmptyGeometry_() { const isEmpty = this.isTokenType(TokenType.TEXT) && this.token_.value == EMPTY; if (isEmpty) { this.consume_(); } return isEmpty; } /** * Create an error message for an unexpected token error. * @return {string} Error message. * @private */ formatErrorMessage_() { return 'Unexpected `' + this.token_.value + '` at position ' + this.token_.position + ' in `' + this.lexer_.wkt + '`'; } /** * @return {!import("../geom/Geometry.js").default} The geometry. * @private */ parseGeometry_() { const token = this.token_; if (this.match(TokenType.TEXT)) { const geomType = token.value; this.layout_ = this.parseGeometryLayout_(); if (geomType == 'GEOMETRYCOLLECTION') { const geometries = this.parseGeometryCollectionText_(); return new GeometryCollection(geometries); } else { const ctor = GeometryConstructor[geomType]; if (!ctor) { throw new Error('Invalid geometry type: ' + geomType); } let coordinates; switch (geomType) { case 'POINT': { coordinates = this.parsePointText_(); break; } case 'LINESTRING': { coordinates = this.parseLineStringText_(); break; } case 'POLYGON': { coordinates = this.parsePolygonText_(); break; } case 'MULTIPOINT': { coordinates = this.parseMultiPointText_(); break; } case 'MULTILINESTRING': { coordinates = this.parseMultiLineStringText_(); break; } case 'MULTIPOLYGON': { coordinates = this.parseMultiPolygonText_(); break; } default: { throw new Error('Invalid geometry type: ' + geomType); } } if (!coordinates) { if (ctor === GeometryConstructor['POINT']) { coordinates = [NaN, NaN]; } else { coordinates = []; } } return new ctor(coordinates, this.layout_); } } throw new Error(this.formatErrorMessage_()); } } /** * @classdesc * Geometry format for reading and writing data in the `WellKnownText` (WKT) * format. * * @api */ class WKT extends TextFeature { /** * @param {Options=} opt_options Options. */ constructor(opt_options) { super(); const options = opt_options ? opt_options : {}; /** * Split GeometryCollection into multiple features. * @type {boolean} * @private */ this.splitCollection_ = options.splitCollection !== undefined ? options.splitCollection : false; } /** * Parse a WKT string. * @param {string} wkt WKT string. * @return {import("../geom/Geometry.js").default|undefined} * The geometry created. * @private */ parse_(wkt) { const lexer = new Lexer(wkt); const parser = new Parser(lexer); return parser.parse(); } /** * @inheritDoc */ readFeatureFromText(text, opt_options) { const geom = this.readGeometryFromText(text, opt_options); if (geom) { const feature = new Feature(); feature.setGeometry(geom); return feature; } return null; } /** * @inheritDoc */ readFeaturesFromText(text, opt_options) { let geometries = []; const geometry = this.readGeometryFromText(text, opt_options); if (this.splitCollection_ && geometry.getType() == GeometryType.GEOMETRY_COLLECTION) { geometries = (/** @type {GeometryCollection} */ (geometry)) .getGeometriesArray(); } else { geometries = [geometry]; } const features = []; for (let i = 0, ii = geometries.length; i < ii; ++i) { const feature = new Feature(); feature.setGeometry(geometries[i]); features.push(feature); } return features; } /** * @inheritDoc */ readGeometryFromText(text, opt_options) { const geometry = this.parse_(text); if (geometry) { return ( /** @type {import("../geom/Geometry.js").default} */ (transformWithOptions(geometry, false, opt_options)) ); } else { return null; } } /** * @inheritDoc */ writeFeatureText(feature, opt_options) { const geometry = feature.getGeometry(); if (geometry) { return this.writeGeometryText(geometry, opt_options); } return ''; } /** * @inheritDoc */ writeFeaturesText(features, opt_options) { if (features.length == 1) { return this.writeFeatureText(features[0], opt_options); } const geometries = []; for (let i = 0, ii = features.length; i < ii; ++i) { geometries.push(features[i].getGeometry()); } const collection = new GeometryCollection(geometries); return this.writeGeometryText(collection, opt_options); } /** * @inheritDoc */ writeGeometryText(geometry, opt_options) { return encode(/** @type {import("../geom/Geometry.js").default} */ ( transformWithOptions(geometry, true, opt_options))); } } /** * @param {Point} geom Point geometry. * @return {string} Coordinates part of Point as WKT. */ function encodePointGeometry(geom) { const coordinates = geom.getCoordinates(); if (coordinates.length === 0) { return ''; } return coordinates.join(' '); } /** * @param {MultiPoint} geom MultiPoint geometry. * @return {string} Coordinates part of MultiPoint as WKT. */ function encodeMultiPointGeometry(geom) { const array = []; const components = geom.getPoints(); for (let i = 0, ii = components.length; i < ii; ++i) { array.push('(' + encodePointGeometry(components[i]) + ')'); } return array.join(','); } /** * @param {GeometryCollection} geom GeometryCollection geometry. * @return {string} Coordinates part of GeometryCollection as WKT. */ function encodeGeometryCollectionGeometry(geom) { const array = []; const geoms = geom.getGeometries(); for (let i = 0, ii = geoms.length; i < ii; ++i) { array.push(encode(geoms[i])); } return array.join(','); } /** * @param {LineString|import("../geom/LinearRing.js").default} geom LineString geometry. * @return {string} Coordinates part of LineString as WKT. */ function encodeLineStringGeometry(geom) { const coordinates = geom.getCoordinates(); const array = []; for (let i = 0, ii = coordinates.length; i < ii; ++i) { array.push(coordinates[i].join(' ')); } return array.join(','); } /** * @param {MultiLineString} geom MultiLineString geometry. * @return {string} Coordinates part of MultiLineString as WKT. */ function encodeMultiLineStringGeometry(geom) { const array = []; const components = geom.getLineStrings(); for (let i = 0, ii = components.length; i < ii; ++i) { array.push('(' + encodeLineStringGeometry(components[i]) + ')'); } return array.join(','); } /** * @param {Polygon} geom Polygon geometry. * @return {string} Coordinates part of Polygon as WKT. */ function encodePolygonGeometry(geom) { const array = []; const rings = geom.getLinearRings(); for (let i = 0, ii = rings.length; i < ii; ++i) { array.push('(' + encodeLineStringGeometry(rings[i]) + ')'); } return array.join(','); } /** * @param {MultiPolygon} geom MultiPolygon geometry. * @return {string} Coordinates part of MultiPolygon as WKT. */ function encodeMultiPolygonGeometry(geom) { const array = []; const components = geom.getPolygons(); for (let i = 0, ii = components.length; i < ii; ++i) { array.push('(' + encodePolygonGeometry(components[i]) + ')'); } return array.join(','); } /** * @param {import("../geom/SimpleGeometry.js").default} geom SimpleGeometry geometry. * @return {string} Potential dimensional information for WKT type. */ function encodeGeometryLayout(geom) { const layout = geom.getLayout(); let dimInfo = ''; if (layout === GeometryLayout.XYZ || layout === GeometryLayout.XYZM) { dimInfo += Z; } if (layout === GeometryLayout.XYM || layout === GeometryLayout.XYZM) { dimInfo += M; } return dimInfo; } /** * @const * @type {Object} */ const GeometryEncoder = { 'Point': encodePointGeometry, 'LineString': encodeLineStringGeometry, 'Polygon': encodePolygonGeometry, 'MultiPoint': encodeMultiPointGeometry, 'MultiLineString': encodeMultiLineStringGeometry, 'MultiPolygon': encodeMultiPolygonGeometry, 'GeometryCollection': encodeGeometryCollectionGeometry }; /** * Encode a geometry as WKT. * @param {!import("../geom/Geometry.js").default} geom The geometry to encode. * @return {string} WKT string for the geometry. */ function encode(geom) { let type = geom.getType(); const geometryEncoder = GeometryEncoder[type]; const enc = geometryEncoder(geom); type = type.toUpperCase(); if (typeof /** @type {?} */ (geom).getFlatCoordinates === 'function') { const dimInfo = encodeGeometryLayout(/** @type {import("../geom/SimpleGeometry.js").default} */ (geom)); if (dimInfo.length > 0) { type += ' ' + dimInfo; } } if (enc.length === 0) { return type + ' ' + EMPTY; } return type + '(' + enc + ')'; } export default WKT;