UNPKG

ol

Version:

OpenLayers mapping library

1,494 lines • 95.5 kB
var __extends = (this && this.__extends) || (function () { var extendStatics = function (d, b) { extendStatics = Object.setPrototypeOf || ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) || function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; }; return extendStatics(d, b); }; return function (d, b) { extendStatics(d, b); function __() { this.constructor = d; } d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __()); }; })(); /** * @module ol/format/KML */ import Feature from '../Feature.js'; import { extend, includes } from '../array.js'; import { assert } from '../asserts.js'; import { asArray } from '../color.js'; import { transformGeometryWithOptions } from './Feature.js'; import XMLFeature from './XMLFeature.js'; import { readDecimal, readBoolean, readString, writeStringTextNode, writeCDATASection, writeDecimalTextNode, writeBooleanTextNode } from './xsd.js'; import GeometryCollection from '../geom/GeometryCollection.js'; import GeometryLayout from '../geom/GeometryLayout.js'; import GeometryType from '../geom/GeometryType.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'; import { toRadians } from '../math.js'; import { get as getProjection } from '../proj.js'; import Fill from '../style/Fill.js'; import Icon from '../style/Icon.js'; import IconAnchorUnits from '../style/IconAnchorUnits.js'; import IconOrigin from '../style/IconOrigin.js'; import Stroke from '../style/Stroke.js'; import Style from '../style/Style.js'; import Text from '../style/Text.js'; import { createElementNS, getAllTextContent, isDocument, makeArrayExtender, makeArrayPusher, makeChildAppender, makeObjectPropertySetter, makeReplacer, makeSequence, makeSimpleNodeFactory, makeStructureNS, OBJECT_PROPERTY_NODE_FACTORY, parse, parseNode, pushParseAndPop, pushSerializeAndPop, XML_SCHEMA_INSTANCE_URI } from '../xml.js'; /** * @typedef {Object} Vec2 * @property {number} x * @property {IconAnchorUnits} xunits * @property {number} y * @property {IconAnchorUnits} yunits * @property {IconOrigin} origin */ /** * @typedef {Object} GxTrackObject * @property {Array<number>} flatCoordinates * @property {Array<number>} whens */ /** * @const * @type {Array<string>} */ var GX_NAMESPACE_URIS = [ 'http://www.google.com/kml/ext/2.2' ]; /** * @const * @type {Array<null|string>} */ var NAMESPACE_URIS = [ null, 'http://earth.google.com/kml/2.0', 'http://earth.google.com/kml/2.1', 'http://earth.google.com/kml/2.2', 'http://www.opengis.net/kml/2.2' ]; /** * @const * @type {string} */ var SCHEMA_LOCATION = 'http://www.opengis.net/kml/2.2 ' + 'https://developers.google.com/kml/schema/kml22gx.xsd'; /** * @type {Object<string, IconAnchorUnits>} */ var ICON_ANCHOR_UNITS_MAP = { 'fraction': IconAnchorUnits.FRACTION, 'pixels': IconAnchorUnits.PIXELS, 'insetPixels': IconAnchorUnits.PIXELS }; /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var PLACEMARK_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'ExtendedData': extendedDataParser, 'Region': regionParser, 'MultiGeometry': makeObjectPropertySetter(readMultiGeometry, 'geometry'), 'LineString': makeObjectPropertySetter(readLineString, 'geometry'), 'LinearRing': makeObjectPropertySetter(readLinearRing, 'geometry'), 'Point': makeObjectPropertySetter(readPoint, 'geometry'), 'Polygon': makeObjectPropertySetter(readPolygon, 'geometry'), 'Style': makeObjectPropertySetter(readStyle), 'StyleMap': placemarkStyleMapParser, 'address': makeObjectPropertySetter(readString), 'description': makeObjectPropertySetter(readString), 'name': makeObjectPropertySetter(readString), 'open': makeObjectPropertySetter(readBoolean), 'phoneNumber': makeObjectPropertySetter(readString), 'styleUrl': makeObjectPropertySetter(readURI), 'visibility': makeObjectPropertySetter(readBoolean) }, makeStructureNS(GX_NAMESPACE_URIS, { 'MultiTrack': makeObjectPropertySetter(readGxMultiTrack, 'geometry'), 'Track': makeObjectPropertySetter(readGxTrack, 'geometry') })); /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var NETWORK_LINK_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'ExtendedData': extendedDataParser, 'Region': regionParser, 'Link': linkParser, 'address': makeObjectPropertySetter(readString), 'description': makeObjectPropertySetter(readString), 'name': makeObjectPropertySetter(readString), 'open': makeObjectPropertySetter(readBoolean), 'phoneNumber': makeObjectPropertySetter(readString), 'visibility': makeObjectPropertySetter(readBoolean) }); /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var LINK_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'href': makeObjectPropertySetter(readURI) }); /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var REGION_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'LatLonAltBox': latLonAltBoxParser, 'Lod': lodParser }); /** * @const * @type {Object<string, Array<string>>} */ // @ts-ignore var KML_SEQUENCE = makeStructureNS(NAMESPACE_URIS, [ 'Document', 'Placemark' ]); /** * @const * @type {Object<string, Object<string, import("../xml.js").Serializer>>} */ // @ts-ignore var KML_SERIALIZERS = makeStructureNS(NAMESPACE_URIS, { 'Document': makeChildAppender(writeDocument), 'Placemark': makeChildAppender(writePlacemark) }); /** * @type {import("../color.js").Color} */ var DEFAULT_COLOR; /** * @type {Fill} */ var DEFAULT_FILL_STYLE = null; /** * Get the default fill style (or null if not yet set). * @return {Fill} The default fill style. */ export function getDefaultFillStyle() { return DEFAULT_FILL_STYLE; } /** * @type {import("../size.js").Size} */ var DEFAULT_IMAGE_STYLE_ANCHOR; /** * @type {IconAnchorUnits} */ var DEFAULT_IMAGE_STYLE_ANCHOR_X_UNITS; /** * @type {IconAnchorUnits} */ var DEFAULT_IMAGE_STYLE_ANCHOR_Y_UNITS; /** * @type {import("../size.js").Size} */ var DEFAULT_IMAGE_STYLE_SIZE; /** * @type {string} */ var DEFAULT_IMAGE_STYLE_SRC; /** * @type {number} */ var DEFAULT_IMAGE_SCALE_MULTIPLIER; /** * @type {import("../style/Image.js").default} */ var DEFAULT_IMAGE_STYLE = null; /** * Get the default image style (or null if not yet set). * @return {import("../style/Image.js").default} The default image style. */ export function getDefaultImageStyle() { return DEFAULT_IMAGE_STYLE; } /** * @type {string} */ var DEFAULT_NO_IMAGE_STYLE; /** * @type {Stroke} */ var DEFAULT_STROKE_STYLE = null; /** * Get the default stroke style (or null if not yet set). * @return {Stroke} The default stroke style. */ export function getDefaultStrokeStyle() { return DEFAULT_STROKE_STYLE; } /** * @type {Stroke} */ var DEFAULT_TEXT_STROKE_STYLE; /** * @type {Text} */ var DEFAULT_TEXT_STYLE = null; /** * Get the default text style (or null if not yet set). * @return {Text} The default text style. */ export function getDefaultTextStyle() { return DEFAULT_TEXT_STYLE; } /** * @type {Style} */ var DEFAULT_STYLE = null; /** * Get the default style (or null if not yet set). * @return {Style} The default style. */ export function getDefaultStyle() { return DEFAULT_STYLE; } /** * @type {Array<Style>} */ var DEFAULT_STYLE_ARRAY = null; /** * Get the default style array (or null if not yet set). * @return {Array<Style>} The default style. */ export function getDefaultStyleArray() { return DEFAULT_STYLE_ARRAY; } function createStyleDefaults() { DEFAULT_COLOR = [255, 255, 255, 1]; DEFAULT_FILL_STYLE = new Fill({ color: DEFAULT_COLOR }); DEFAULT_IMAGE_STYLE_ANCHOR = [20, 2]; // FIXME maybe [8, 32] ? DEFAULT_IMAGE_STYLE_ANCHOR_X_UNITS = IconAnchorUnits.PIXELS; DEFAULT_IMAGE_STYLE_ANCHOR_Y_UNITS = IconAnchorUnits.PIXELS; DEFAULT_IMAGE_STYLE_SIZE = [64, 64]; DEFAULT_IMAGE_STYLE_SRC = 'https://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png'; DEFAULT_IMAGE_SCALE_MULTIPLIER = 0.5; DEFAULT_IMAGE_STYLE = new Icon({ anchor: DEFAULT_IMAGE_STYLE_ANCHOR, anchorOrigin: IconOrigin.BOTTOM_LEFT, anchorXUnits: DEFAULT_IMAGE_STYLE_ANCHOR_X_UNITS, anchorYUnits: DEFAULT_IMAGE_STYLE_ANCHOR_Y_UNITS, crossOrigin: 'anonymous', rotation: 0, scale: DEFAULT_IMAGE_SCALE_MULTIPLIER, size: DEFAULT_IMAGE_STYLE_SIZE, src: DEFAULT_IMAGE_STYLE_SRC }); DEFAULT_NO_IMAGE_STYLE = 'NO_IMAGE'; DEFAULT_STROKE_STYLE = new Stroke({ color: DEFAULT_COLOR, width: 1 }); DEFAULT_TEXT_STROKE_STYLE = new Stroke({ color: [51, 51, 51, 1], width: 2 }); DEFAULT_TEXT_STYLE = new Text({ font: 'bold 16px Helvetica', fill: DEFAULT_FILL_STYLE, stroke: DEFAULT_TEXT_STROKE_STYLE, scale: 0.8 }); DEFAULT_STYLE = new Style({ fill: DEFAULT_FILL_STYLE, image: DEFAULT_IMAGE_STYLE, text: DEFAULT_TEXT_STYLE, stroke: DEFAULT_STROKE_STYLE, zIndex: 0 }); DEFAULT_STYLE_ARRAY = [DEFAULT_STYLE]; } /** * @type {HTMLTextAreaElement} */ var TEXTAREA; /** * @typedef {Object} Options * @property {boolean} [extractStyles=true] Extract styles from the KML. * @property {boolean} [showPointNames=true] Show names as labels for placemarks which contain points. * @property {Array<Style>} [defaultStyle] Default style. The * default default style is the same as Google Earth. * @property {boolean} [writeStyles=true] Write styles into KML. * @property {null|string} [crossOrigin='anonymous'] The `crossOrigin` attribute for loaded images. Note that you must provide a * `crossOrigin` value if you want to access pixel data with the Canvas renderer. */ /** * @classdesc * Feature format for reading and writing data in the KML format. * * {@link module:ol/format/KML~KML#readFeature} will read the first feature from * a KML source. * * MultiGeometries are converted into GeometryCollections if they are a mix of * geometry types, and into MultiPoint/MultiLineString/MultiPolygon if they are * all of the same type. * * Note that the KML format uses the URL() constructor. Older browsers such as IE * which do not support this will need a URL polyfill to be loaded before use. * * @api */ var KML = /** @class */ (function (_super) { __extends(KML, _super); /** * @param {Options=} opt_options Options. */ function KML(opt_options) { var _this = _super.call(this) || this; var options = opt_options ? opt_options : {}; if (!DEFAULT_STYLE_ARRAY) { createStyleDefaults(); } /** * @inheritDoc */ _this.dataProjection = getProjection('EPSG:4326'); /** * @private * @type {Array<Style>} */ _this.defaultStyle_ = options.defaultStyle ? options.defaultStyle : DEFAULT_STYLE_ARRAY; /** * @private * @type {boolean} */ _this.extractStyles_ = options.extractStyles !== undefined ? options.extractStyles : true; /** * @private * @type {boolean} */ _this.writeStyles_ = options.writeStyles !== undefined ? options.writeStyles : true; /** * @private * @type {!Object<string, (Array<Style>|string)>} */ _this.sharedStyles_ = {}; /** * @private * @type {boolean} */ _this.showPointNames_ = options.showPointNames !== undefined ? options.showPointNames : true; /** * @private * @type {null|string} */ _this.crossOrigin_ = options.crossOrigin !== undefined ? options.crossOrigin : 'anonymous'; return _this; } /** * @param {Node} node Node. * @param {Array<*>} objectStack Object stack. * @private * @return {Array<Feature>|undefined} Features. */ KML.prototype.readDocumentOrFolder_ = function (node, objectStack) { // FIXME use scope somehow var parsersNS = makeStructureNS(NAMESPACE_URIS, { 'Document': makeArrayExtender(this.readDocumentOrFolder_, this), 'Folder': makeArrayExtender(this.readDocumentOrFolder_, this), 'Placemark': makeArrayPusher(this.readPlacemark_, this), 'Style': this.readSharedStyle_.bind(this), 'StyleMap': this.readSharedStyleMap_.bind(this) }); /** @type {Array<Feature>} */ // @ts-ignore var features = pushParseAndPop([], parsersNS, node, objectStack, this); if (features) { return features; } else { return undefined; } }; /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @private * @return {Feature|undefined} Feature. */ KML.prototype.readPlacemark_ = function (node, objectStack) { var object = pushParseAndPop({ 'geometry': null }, PLACEMARK_PARSERS, node, objectStack, this); if (!object) { return undefined; } var feature = new Feature(); var id = node.getAttribute('id'); if (id !== null) { feature.setId(id); } var options = /** @type {import("./Feature.js").ReadOptions} */ (objectStack[0]); var geometry = object['geometry']; if (geometry) { transformGeometryWithOptions(geometry, false, options); } feature.setGeometry(geometry); delete object['geometry']; if (this.extractStyles_) { var style = object['Style']; var styleUrl = object['styleUrl']; var styleFunction = createFeatureStyleFunction(style, styleUrl, this.defaultStyle_, this.sharedStyles_, this.showPointNames_); feature.setStyle(styleFunction); } delete object['Style']; // we do not remove the styleUrl property from the object, so it // gets stored on feature when setProperties is called feature.setProperties(object, true); return feature; }; /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @private */ KML.prototype.readSharedStyle_ = function (node, objectStack) { var id = node.getAttribute('id'); if (id !== null) { var style = readStyle.call(this, node, objectStack); if (style) { var styleUri = void 0; var baseURI = node.baseURI; if (!baseURI || baseURI == 'about:blank') { baseURI = window.location.href; } if (baseURI) { var url = new URL('#' + id, baseURI); styleUri = url.href; } else { styleUri = '#' + id; } this.sharedStyles_[styleUri] = style; } } }; /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @private */ KML.prototype.readSharedStyleMap_ = function (node, objectStack) { var id = node.getAttribute('id'); if (id === null) { return; } var styleMapValue = readStyleMapValue.call(this, node, objectStack); if (!styleMapValue) { return; } var styleUri; var baseURI = node.baseURI; if (!baseURI || baseURI == 'about:blank') { baseURI = window.location.href; } if (baseURI) { var url = new URL('#' + id, baseURI); styleUri = url.href; } else { styleUri = '#' + id; } this.sharedStyles_[styleUri] = styleMapValue; }; /** * @inheritDoc */ KML.prototype.readFeatureFromNode = function (node, opt_options) { if (!includes(NAMESPACE_URIS, node.namespaceURI)) { return null; } var feature = this.readPlacemark_(node, [this.getReadOptions(node, opt_options)]); if (feature) { return feature; } else { return null; } }; /** * @inheritDoc */ KML.prototype.readFeaturesFromNode = function (node, opt_options) { if (!includes(NAMESPACE_URIS, node.namespaceURI)) { return []; } var features; var localName = node.localName; if (localName == 'Document' || localName == 'Folder') { features = this.readDocumentOrFolder_(node, [this.getReadOptions(node, opt_options)]); if (features) { return features; } else { return []; } } else if (localName == 'Placemark') { var feature = this.readPlacemark_(node, [this.getReadOptions(node, opt_options)]); if (feature) { return [feature]; } else { return []; } } else if (localName == 'kml') { features = []; for (var n = node.firstElementChild; n; n = n.nextElementSibling) { var fs = this.readFeaturesFromNode(n, opt_options); if (fs) { extend(features, fs); } } return features; } else { return []; } }; /** * Read the name of the KML. * * @param {Document|Element|string} source Source. * @return {string|undefined} Name. * @api */ KML.prototype.readName = function (source) { if (!source) { return undefined; } else if (typeof source === 'string') { var doc = parse(source); return this.readNameFromDocument(doc); } else if (isDocument(source)) { return this.readNameFromDocument(/** @type {Document} */ (source)); } else { return this.readNameFromNode(/** @type {Element} */ (source)); } }; /** * @param {Document} doc Document. * @return {string|undefined} Name. */ KML.prototype.readNameFromDocument = function (doc) { for (var n = /** @type {Node} */ (doc.firstChild); n; n = n.nextSibling) { if (n.nodeType == Node.ELEMENT_NODE) { var name_1 = this.readNameFromNode(/** @type {Element} */ (n)); if (name_1) { return name_1; } } } return undefined; }; /** * @param {Element} node Node. * @return {string|undefined} Name. */ KML.prototype.readNameFromNode = function (node) { for (var n = node.firstElementChild; n; n = n.nextElementSibling) { if (includes(NAMESPACE_URIS, n.namespaceURI) && n.localName == 'name') { return readString(n); } } for (var n = node.firstElementChild; n; n = n.nextElementSibling) { var localName = n.localName; if (includes(NAMESPACE_URIS, n.namespaceURI) && (localName == 'Document' || localName == 'Folder' || localName == 'Placemark' || localName == 'kml')) { var name_2 = this.readNameFromNode(n); if (name_2) { return name_2; } } } return undefined; }; /** * Read the network links of the KML. * * @param {Document|Element|string} source Source. * @return {Array<Object>} Network links. * @api */ KML.prototype.readNetworkLinks = function (source) { var networkLinks = []; if (typeof source === 'string') { var doc = parse(source); extend(networkLinks, this.readNetworkLinksFromDocument(doc)); } else if (isDocument(source)) { extend(networkLinks, this.readNetworkLinksFromDocument( /** @type {Document} */ (source))); } else { extend(networkLinks, this.readNetworkLinksFromNode( /** @type {Element} */ (source))); } return networkLinks; }; /** * @param {Document} doc Document. * @return {Array<Object>} Network links. */ KML.prototype.readNetworkLinksFromDocument = function (doc) { var networkLinks = []; for (var n = /** @type {Node} */ (doc.firstChild); n; n = n.nextSibling) { if (n.nodeType == Node.ELEMENT_NODE) { extend(networkLinks, this.readNetworkLinksFromNode(/** @type {Element} */ (n))); } } return networkLinks; }; /** * @param {Element} node Node. * @return {Array<Object>} Network links. */ KML.prototype.readNetworkLinksFromNode = function (node) { var networkLinks = []; for (var n = node.firstElementChild; n; n = n.nextElementSibling) { if (includes(NAMESPACE_URIS, n.namespaceURI) && n.localName == 'NetworkLink') { var obj = pushParseAndPop({}, NETWORK_LINK_PARSERS, n, []); networkLinks.push(obj); } } for (var n = node.firstElementChild; n; n = n.nextElementSibling) { var localName = n.localName; if (includes(NAMESPACE_URIS, n.namespaceURI) && (localName == 'Document' || localName == 'Folder' || localName == 'kml')) { extend(networkLinks, this.readNetworkLinksFromNode(n)); } } return networkLinks; }; /** * Read the regions of the KML. * * @param {Document|Element|string} source Source. * @return {Array<Object>} Regions. * @api */ KML.prototype.readRegion = function (source) { var regions = []; if (typeof source === 'string') { var doc = parse(source); extend(regions, this.readRegionFromDocument(doc)); } else if (isDocument(source)) { extend(regions, this.readRegionFromDocument( /** @type {Document} */ (source))); } else { extend(regions, this.readRegionFromNode( /** @type {Element} */ (source))); } return regions; }; /** * @param {Document} doc Document. * @return {Array<Object>} Region. */ KML.prototype.readRegionFromDocument = function (doc) { var regions = []; for (var n = /** @type {Node} */ (doc.firstChild); n; n = n.nextSibling) { if (n.nodeType == Node.ELEMENT_NODE) { extend(regions, this.readRegionFromNode(/** @type {Element} */ (n))); } } return regions; }; /** * @param {Element} node Node. * @return {Array<Object>} Region. * @api */ KML.prototype.readRegionFromNode = function (node) { var regions = []; for (var n = node.firstElementChild; n; n = n.nextElementSibling) { if (includes(NAMESPACE_URIS, n.namespaceURI) && n.localName == 'Region') { var obj = pushParseAndPop({}, REGION_PARSERS, n, []); regions.push(obj); } } for (var n = node.firstElementChild; n; n = n.nextElementSibling) { var localName = n.localName; if (includes(NAMESPACE_URIS, n.namespaceURI) && (localName == 'Document' || localName == 'Folder' || localName == 'kml')) { extend(regions, this.readRegionFromNode(n)); } } return regions; }; /** * Encode an array of features in the KML format as an XML node. GeometryCollections, * MultiPoints, MultiLineStrings, and MultiPolygons are output as MultiGeometries. * * @param {Array<Feature>} features Features. * @param {import("./Feature.js").WriteOptions=} opt_options Options. * @return {Node} Node. * @override * @api */ KML.prototype.writeFeaturesNode = function (features, opt_options) { opt_options = this.adaptOptions(opt_options); var kml = createElementNS(NAMESPACE_URIS[4], 'kml'); var xmlnsUri = 'http://www.w3.org/2000/xmlns/'; kml.setAttributeNS(xmlnsUri, 'xmlns:gx', GX_NAMESPACE_URIS[0]); kml.setAttributeNS(xmlnsUri, 'xmlns:xsi', XML_SCHEMA_INSTANCE_URI); kml.setAttributeNS(XML_SCHEMA_INSTANCE_URI, 'xsi:schemaLocation', SCHEMA_LOCATION); var /** @type {import("../xml.js").NodeStackItem} */ context = { node: kml }; /** @type {!Object<string, (Array<Feature>|Feature|undefined)>} */ var properties = {}; if (features.length > 1) { properties['Document'] = features; } else if (features.length == 1) { properties['Placemark'] = features[0]; } var orderedKeys = KML_SEQUENCE[kml.namespaceURI]; var values = makeSequence(properties, orderedKeys); pushSerializeAndPop(context, KML_SERIALIZERS, OBJECT_PROPERTY_NODE_FACTORY, values, [opt_options], orderedKeys, this); return kml; }; return KML; }(XMLFeature)); /** * @param {Style|undefined} foundStyle Style. * @param {string} name Name. * @return {Style} style Style. */ function createNameStyleFunction(foundStyle, name) { var textOffset = [0, 0]; var textAlign = 'start'; var imageStyle = foundStyle.getImage(); if (imageStyle) { var imageSize = imageStyle.getImageSize(); if (imageSize === null) { imageSize = DEFAULT_IMAGE_STYLE_SIZE; } if (imageSize.length == 2) { var imageScale = imageStyle.getScale(); // Offset the label to be centered to the right of the icon, // if there is one. textOffset[0] = imageScale * imageSize[0] / 2; textOffset[1] = -imageScale * imageSize[1] / 2; textAlign = 'left'; } } var textStyle = foundStyle.getText(); if (textStyle) { // clone the text style, customizing it with name, alignments and offset. // Note that kml does not support many text options that OpenLayers does (rotation, textBaseline). textStyle = textStyle.clone(); textStyle.setFont(textStyle.getFont() || DEFAULT_TEXT_STYLE.getFont()); textStyle.setScale(textStyle.getScale() || DEFAULT_TEXT_STYLE.getScale()); textStyle.setFill(textStyle.getFill() || DEFAULT_TEXT_STYLE.getFill()); textStyle.setStroke(textStyle.getStroke() || DEFAULT_TEXT_STROKE_STYLE); } else { textStyle = DEFAULT_TEXT_STYLE.clone(); } textStyle.setText(name); textStyle.setOffsetX(textOffset[0]); textStyle.setOffsetY(textOffset[1]); textStyle.setTextAlign(textAlign); var nameStyle = new Style({ image: imageStyle, text: textStyle }); return nameStyle; } /** * @param {Array<Style>|undefined} style Style. * @param {string} styleUrl Style URL. * @param {Array<Style>} defaultStyle Default style. * @param {!Object<string, (Array<Style>|string)>} sharedStyles Shared styles. * @param {boolean|undefined} showPointNames true to show names for point placemarks. * @return {import("../style/Style.js").StyleFunction} Feature style function. */ function createFeatureStyleFunction(style, styleUrl, defaultStyle, sharedStyles, showPointNames) { return ( /** * @param {Feature} feature feature. * @param {number} resolution Resolution. * @return {Array<Style>|Style} Style. */ function (feature, resolution) { var drawName = showPointNames; var name = ''; var multiGeometryPoints = []; if (drawName) { var geometry = feature.getGeometry(); if (geometry) { var type = geometry.getType(); if (type === GeometryType.GEOMETRY_COLLECTION) { multiGeometryPoints = geometry.getGeometriesArrayRecursive().filter(function (geometry) { var type = geometry.getType(); return type === GeometryType.POINT || type === GeometryType.MULTI_POINT; }); drawName = multiGeometryPoints.length > 0; } else { drawName = type === GeometryType.POINT || type === GeometryType.MULTI_POINT; } } } if (drawName) { name = /** @type {string} */ (feature.get('name')); drawName = drawName && !!name; // convert any html character codes if (drawName && name.search(/&[^&]+;/) > -1) { if (!TEXTAREA) { TEXTAREA = document.createElement('textarea'); } TEXTAREA.innerHTML = name; name = TEXTAREA.value; } } var featureStyle = defaultStyle; if (style) { featureStyle = style; } else if (styleUrl) { featureStyle = findStyle(styleUrl, defaultStyle, sharedStyles); } if (drawName) { var nameStyle = createNameStyleFunction(featureStyle[0], name); if (multiGeometryPoints.length > 0) { // in multigeometries restrict the name style to points and create a // style without image or text for geometries requiring fill or stroke // including any polygon specific style if there is one nameStyle.setGeometry(new GeometryCollection(multiGeometryPoints)); var baseStyle = new Style({ geometry: featureStyle[0].getGeometry(), image: null, fill: featureStyle[0].getFill(), stroke: featureStyle[0].getStroke(), text: null }); return [nameStyle, baseStyle].concat(featureStyle.slice(1)); } return nameStyle; } return featureStyle; }); } /** * @param {Array<Style>|string|undefined} styleValue Style value. * @param {Array<Style>} defaultStyle Default style. * @param {!Object<string, (Array<Style>|string)>} sharedStyles * Shared styles. * @return {Array<Style>} Style. */ function findStyle(styleValue, defaultStyle, sharedStyles) { if (Array.isArray(styleValue)) { return styleValue; } else if (typeof styleValue === 'string') { // KML files in the wild occasionally forget the leading `#` on styleUrls // defined in the same document. Add a leading `#` if it enables to find // a style. if (!(styleValue in sharedStyles) && ('#' + styleValue in sharedStyles)) { styleValue = '#' + styleValue; } return findStyle(sharedStyles[styleValue], defaultStyle, sharedStyles); } else { return defaultStyle; } } /** * @param {Node} node Node. * @return {import("../color.js").Color|undefined} Color. */ function readColor(node) { var s = getAllTextContent(node, false); // The KML specification states that colors should not include a leading `#` // but we tolerate them. var m = /^\s*#?\s*([0-9A-Fa-f]{8})\s*$/.exec(s); if (m) { var hexColor = m[1]; return [ parseInt(hexColor.substr(6, 2), 16), parseInt(hexColor.substr(4, 2), 16), parseInt(hexColor.substr(2, 2), 16), parseInt(hexColor.substr(0, 2), 16) / 255 ]; } else { return undefined; } } /** * @param {Node} node Node. * @return {Array<number>|undefined} Flat coordinates. */ export function readFlatCoordinates(node) { var s = getAllTextContent(node, false); var flatCoordinates = []; // The KML specification states that coordinate tuples should not include // spaces, but we tolerate them. var re = /^\s*([+\-]?\d*\.?\d+(?:e[+\-]?\d+)?)\s*,\s*([+\-]?\d*\.?\d+(?:e[+\-]?\d+)?)(?:\s*,\s*([+\-]?\d*\.?\d+(?:e[+\-]?\d+)?))?\s*/i; var m; while ((m = re.exec(s))) { var x = parseFloat(m[1]); var y = parseFloat(m[2]); var z = m[3] ? parseFloat(m[3]) : 0; flatCoordinates.push(x, y, z); s = s.substr(m[0].length); } if (s !== '') { return undefined; } return flatCoordinates; } /** * @param {Node} node Node. * @return {string} URI. */ function readURI(node) { var s = getAllTextContent(node, false).trim(); var baseURI = node.baseURI; if (!baseURI || baseURI == 'about:blank') { baseURI = window.location.href; } if (baseURI) { var url = new URL(s, baseURI); return url.href; } else { return s; } } /** * @param {Element} node Node. * @return {Vec2} Vec2. */ function readVec2(node) { var xunits = node.getAttribute('xunits'); var yunits = node.getAttribute('yunits'); var origin; if (xunits !== 'insetPixels') { if (yunits !== 'insetPixels') { origin = IconOrigin.BOTTOM_LEFT; } else { origin = IconOrigin.TOP_LEFT; } } else { if (yunits !== 'insetPixels') { origin = IconOrigin.BOTTOM_RIGHT; } else { origin = IconOrigin.TOP_RIGHT; } } return { x: parseFloat(node.getAttribute('x')), xunits: ICON_ANCHOR_UNITS_MAP[xunits], y: parseFloat(node.getAttribute('y')), yunits: ICON_ANCHOR_UNITS_MAP[yunits], origin: origin }; } /** * @param {Node} node Node. * @return {number|undefined} Scale. */ function readScale(node) { return readDecimal(node); } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var STYLE_MAP_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'Pair': pairDataParser }); /** * @this {KML} * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {Array<Style>|string|undefined} StyleMap. */ function readStyleMapValue(node, objectStack) { return pushParseAndPop(undefined, STYLE_MAP_PARSERS, node, objectStack, this); } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var ICON_STYLE_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'Icon': makeObjectPropertySetter(readIcon), 'color': makeObjectPropertySetter(readColor), 'heading': makeObjectPropertySetter(readDecimal), 'hotSpot': makeObjectPropertySetter(readVec2), 'scale': makeObjectPropertySetter(readScale) }); /** * @this {KML} * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. */ function iconStyleParser(node, objectStack) { // FIXME refreshMode // FIXME refreshInterval // FIXME viewRefreshTime // FIXME viewBoundScale // FIXME viewFormat // FIXME httpQuery var object = pushParseAndPop({}, ICON_STYLE_PARSERS, node, objectStack); if (!object) { return; } var styleObject = /** @type {Object} */ (objectStack[objectStack.length - 1]); var IconObject = 'Icon' in object ? object['Icon'] : {}; var drawIcon = (!('Icon' in object) || Object.keys(IconObject).length > 0); var src; var href = /** @type {string|undefined} */ (IconObject['href']); if (href) { src = href; } else if (drawIcon) { src = DEFAULT_IMAGE_STYLE_SRC; } var anchor, anchorXUnits, anchorYUnits; var anchorOrigin = IconOrigin.BOTTOM_LEFT; var hotSpot = /** @type {Vec2|undefined} */ (object['hotSpot']); if (hotSpot) { anchor = [hotSpot.x, hotSpot.y]; anchorXUnits = hotSpot.xunits; anchorYUnits = hotSpot.yunits; anchorOrigin = hotSpot.origin; } else if (src === DEFAULT_IMAGE_STYLE_SRC) { anchor = DEFAULT_IMAGE_STYLE_ANCHOR; anchorXUnits = DEFAULT_IMAGE_STYLE_ANCHOR_X_UNITS; anchorYUnits = DEFAULT_IMAGE_STYLE_ANCHOR_Y_UNITS; } else if (/^http:\/\/maps\.(?:google|gstatic)\.com\//.test(src)) { anchor = [0.5, 0]; anchorXUnits = IconAnchorUnits.FRACTION; anchorYUnits = IconAnchorUnits.FRACTION; } var offset; var x = /** @type {number|undefined} */ (IconObject['x']); var y = /** @type {number|undefined} */ (IconObject['y']); if (x !== undefined && y !== undefined) { offset = [x, y]; } var size; var w = /** @type {number|undefined} */ (IconObject['w']); var h = /** @type {number|undefined} */ (IconObject['h']); if (w !== undefined && h !== undefined) { size = [w, h]; } var rotation; var heading = /** @type {number} */ (object['heading']); if (heading !== undefined) { rotation = toRadians(heading); } var scale = /** @type {number|undefined} */ (object['scale']); var color = /** @type {Array<number>|undefined} */ (object['color']); if (drawIcon) { if (src == DEFAULT_IMAGE_STYLE_SRC) { size = DEFAULT_IMAGE_STYLE_SIZE; if (scale === undefined) { scale = DEFAULT_IMAGE_SCALE_MULTIPLIER; } } var imageStyle = new Icon({ anchor: anchor, anchorOrigin: anchorOrigin, anchorXUnits: anchorXUnits, anchorYUnits: anchorYUnits, crossOrigin: this.crossOrigin_, offset: offset, offsetOrigin: IconOrigin.BOTTOM_LEFT, rotation: rotation, scale: scale, size: size, src: src, color: color }); styleObject['imageStyle'] = imageStyle; } else { // handle the case when we explicitly want to draw no icon. styleObject['imageStyle'] = DEFAULT_NO_IMAGE_STYLE; } } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var LABEL_STYLE_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'color': makeObjectPropertySetter(readColor), 'scale': makeObjectPropertySetter(readScale) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. */ function labelStyleParser(node, objectStack) { // FIXME colorMode var object = pushParseAndPop({}, LABEL_STYLE_PARSERS, node, objectStack); if (!object) { return; } var styleObject = objectStack[objectStack.length - 1]; var textStyle = new Text({ fill: new Fill({ color: /** @type {import("../color.js").Color} */ ('color' in object ? object['color'] : DEFAULT_COLOR) }), scale: /** @type {number|undefined} */ (object['scale']) }); styleObject['textStyle'] = textStyle; } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var LINE_STYLE_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'color': makeObjectPropertySetter(readColor), 'width': makeObjectPropertySetter(readDecimal) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. */ function lineStyleParser(node, objectStack) { // FIXME colorMode // FIXME gx:outerColor // FIXME gx:outerWidth // FIXME gx:physicalWidth // FIXME gx:labelVisibility var object = pushParseAndPop({}, LINE_STYLE_PARSERS, node, objectStack); if (!object) { return; } var styleObject = objectStack[objectStack.length - 1]; var strokeStyle = new Stroke({ color: /** @type {import("../color.js").Color} */ ('color' in object ? object['color'] : DEFAULT_COLOR), width: /** @type {number} */ ('width' in object ? object['width'] : 1) }); styleObject['strokeStyle'] = strokeStyle; } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var POLY_STYLE_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'color': makeObjectPropertySetter(readColor), 'fill': makeObjectPropertySetter(readBoolean), 'outline': makeObjectPropertySetter(readBoolean) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. */ function polyStyleParser(node, objectStack) { // FIXME colorMode var object = pushParseAndPop({}, POLY_STYLE_PARSERS, node, objectStack); if (!object) { return; } var styleObject = objectStack[objectStack.length - 1]; var fillStyle = new Fill({ color: /** @type {import("../color.js").Color} */ ('color' in object ? object['color'] : DEFAULT_COLOR) }); styleObject['fillStyle'] = fillStyle; var fill = /** @type {boolean|undefined} */ (object['fill']); if (fill !== undefined) { styleObject['fill'] = fill; } var outline = /** @type {boolean|undefined} */ (object['outline']); if (outline !== undefined) { styleObject['outline'] = outline; } } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var FLAT_LINEAR_RING_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'coordinates': makeReplacer(readFlatCoordinates) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {Array<number>} LinearRing flat coordinates. */ function readFlatLinearRing(node, objectStack) { return pushParseAndPop(null, FLAT_LINEAR_RING_PARSERS, node, objectStack); } /** * @param {Node} node Node. * @param {Array<*>} objectStack Object stack. */ function gxCoordParser(node, objectStack) { var gxTrackObject = /** @type {GxTrackObject} */ (objectStack[objectStack.length - 1]); var flatCoordinates = gxTrackObject.flatCoordinates; var s = getAllTextContent(node, false); var re = /^\s*([+\-]?\d+(?:\.\d*)?(?:e[+\-]?\d*)?)\s+([+\-]?\d+(?:\.\d*)?(?:e[+\-]?\d*)?)\s+([+\-]?\d+(?:\.\d*)?(?:e[+\-]?\d*)?)\s*$/i; var m = re.exec(s); if (m) { var x = parseFloat(m[1]); var y = parseFloat(m[2]); var z = parseFloat(m[3]); flatCoordinates.push(x, y, z, 0); } else { flatCoordinates.push(0, 0, 0, 0); } } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var GX_MULTITRACK_GEOMETRY_PARSERS = makeStructureNS(GX_NAMESPACE_URIS, { 'Track': makeArrayPusher(readGxTrack) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {MultiLineString|undefined} MultiLineString. */ function readGxMultiTrack(node, objectStack) { var lineStrings = pushParseAndPop([], GX_MULTITRACK_GEOMETRY_PARSERS, node, objectStack); if (!lineStrings) { return undefined; } return new MultiLineString(lineStrings); } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var GX_TRACK_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'when': whenParser }, makeStructureNS(GX_NAMESPACE_URIS, { 'coord': gxCoordParser })); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {LineString|undefined} LineString. */ function readGxTrack(node, objectStack) { var gxTrackObject = pushParseAndPop( /** @type {GxTrackObject} */ ({ flatCoordinates: [], whens: [] }), GX_TRACK_PARSERS, node, objectStack); if (!gxTrackObject) { return undefined; } var flatCoordinates = gxTrackObject.flatCoordinates; var whens = gxTrackObject.whens; for (var i = 0, ii = Math.min(flatCoordinates.length, whens.length); i < ii; ++i) { flatCoordinates[4 * i + 3] = whens[i]; } return new LineString(flatCoordinates, GeometryLayout.XYZM); } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var ICON_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'href': makeObjectPropertySetter(readURI) }, makeStructureNS(GX_NAMESPACE_URIS, { 'x': makeObjectPropertySetter(readDecimal), 'y': makeObjectPropertySetter(readDecimal), 'w': makeObjectPropertySetter(readDecimal), 'h': makeObjectPropertySetter(readDecimal) })); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {Object} Icon object. */ function readIcon(node, objectStack) { var iconObject = pushParseAndPop({}, ICON_PARSERS, node, objectStack); if (iconObject) { return iconObject; } else { return null; } } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var GEOMETRY_FLAT_COORDINATES_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'coordinates': makeReplacer(readFlatCoordinates) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {Array<number>} Flat coordinates. */ function readFlatCoordinatesFromNode(node, objectStack) { return pushParseAndPop(null, GEOMETRY_FLAT_COORDINATES_PARSERS, node, objectStack); } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var EXTRUDE_AND_ALTITUDE_MODE_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'extrude': makeObjectPropertySetter(readBoolean), 'tessellate': makeObjectPropertySetter(readBoolean), 'altitudeMode': makeObjectPropertySetter(readString) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {LineString|undefined} LineString. */ function readLineString(node, objectStack) { var properties = pushParseAndPop({}, EXTRUDE_AND_ALTITUDE_MODE_PARSERS, node, objectStack); var flatCoordinates = readFlatCoordinatesFromNode(node, objectStack); if (flatCoordinates) { var lineString = new LineString(flatCoordinates, GeometryLayout.XYZ); lineString.setProperties(properties, true); return lineString; } else { return undefined; } } /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {Polygon|undefined} Polygon. */ function readLinearRing(node, objectStack) { var properties = pushParseAndPop({}, EXTRUDE_AND_ALTITUDE_MODE_PARSERS, node, objectStack); var flatCoordinates = readFlatCoordinatesFromNode(node, objectStack); if (flatCoordinates) { var polygon = new Polygon(flatCoordinates, GeometryLayout.XYZ, [flatCoordinates.length]); polygon.setProperties(properties, true); return polygon; } else { return undefined; } } /** * @const * @type {Object<string, Object<string, import("../xml.js").Parser>>} */ // @ts-ignore var MULTI_GEOMETRY_PARSERS = makeStructureNS(NAMESPACE_URIS, { 'LineString': makeArrayPusher(readLineString), 'LinearRing': makeArrayPusher(readLinearRing), 'MultiGeometry': makeArrayPusher(readMultiGeometry), 'Point': makeArrayPusher(readPoint), 'Polygon': makeArrayPusher(readPolygon) }); /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {import("../geom/Geometry.js").default} Geometry. */ function readMultiGeometry(node, objectStack) { var geometries = pushParseAndPop([], MULTI_GEOMETRY_PARSERS, node, objectStack); if (!geometries) { return null; } if (geometries.length === 0) { return new GeometryCollection(geometries); } var multiGeometry; var homogeneous = true; var type = geometries[0].getType(); var geometry; for (var i = 1, ii = geometries.length; i < ii; ++i) { geometry = geometries[i]; if (geometry.getType() != type) { homogeneous = false; break; } } if (homogeneous) { var layout = void 0; var flatCoordinates = void 0; if (type == GeometryType.POINT) { var point = geometries[0]; layout = point.getLayout(); flatCoordinates = point.getFlatCoordinates(); for (var i = 1, ii = geometries.length; i < ii; ++i) { geometry = geometries[i]; extend(flatCoordinates, geometry.getFlatCoordinates()); } multiGeometry = new MultiPoint(flatCoordinates, layout); setCommonGeometryProperties(multiGeometry, geometries); } else if (type == GeometryType.LINE_STRING) { multiGeometry = new MultiLineString(geometries); setCommonGeometryProperties(multiGeometry, geometries); } else if (type == GeometryType.POLYGON) { multiGeometry = new MultiPolygon(geometries); setCommonGeometryProperties(multiGeometry, geometries); } else if (type == GeometryType.GEOMETRY_COLLECTION) { multiGeometry = new GeometryCollection(geometries); } else { assert(false, 37); // Unknown geometry type found } } else { multiGeometry = new GeometryCollection(geometries); } return ( /** @type {import("../geom/Geometry.js").default} */ (multiGeometry)); } /** * @param {Element} node Node. * @param {Array<*>} objectStack Object stack. * @return {Point|undefined} Point. */ function readPoint(node, objectStack) { var properties = pushParseAndPop({},