npm - @masterportal/masterportalapi - Versions diffs - 2.1.1 - Mend

@masterportal/masterportalapi 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (92) hide show

package/.editorconfig +15 -0
package/.eslintignore +6 -0
package/.eslintrc +184 -0
package/.husky/pre-push +4 -0
package/CHANGELOG.md +217 -0
package/License.txt +21 -0
package/README.md +24 -0
package/babel.config.json +6 -0
package/example/README.md +7 -0
package/example/config/localGeoJSON.js +956 -0
package/example/config/portal.json +35 -0
package/example/config/services.json +79 -0
package/example/index.html +27 -0
package/example/index.js +210 -0
package/example/style.scss +59 -0
package/jest.config.js +18 -0
package/jest.setup.js +5 -0
package/jsdoc.json +15 -0
package/package.json +62 -0
package/public/marker.svg +1 -0
package/public/stringMarker.js +5 -0
package/src/crs.js +122 -0
package/src/defaults.js +38 -0
package/src/index.js +30 -0
package/src/layer/geojson/index.js +109 -0
package/src/layer/geojson/style.js +61 -0
package/src/layer/lib.js +32 -0
package/src/layer/oaf.js +207 -0
package/src/layer/terrain.js +72 -0
package/src/layer/tileset.js +71 -0
package/src/layer/vector.js +48 -0
package/src/layer/vectorBase.js +39 -0
package/src/layer/wfs.js +218 -0
package/src/layer/wms.js +185 -0
package/src/lib/coordsToPairs.js +15 -0
package/src/lib/getInitialLayers.js +22 -0
package/src/lib/load3DScript.js +22 -0
package/src/lib/oafUtil.js +22 -0
package/src/lib/setBackgroundImage.js +23 -0
package/src/lib/wfsUtil.js +75 -0
package/src/lib/zoomTo.js +40 -0
package/src/maps/api.js +5 -0
package/src/maps/map.js +35 -0
package/src/maps/mapView.js +54 -0
package/src/maps/ol/olMap.js +124 -0
package/src/maps/olcs/3dUtils/fixedOverlaySynchronizer.js +39 -0
package/src/maps/olcs/3dUtils/wmsRasterSynchronizer.js +348 -0
package/src/maps/olcs/olcsMap.js +212 -0
package/src/rawLayerList.js +88 -0
package/src/searchAddress/gazetteerUrl.js +22 -0
package/src/searchAddress/index.js +13 -0
package/src/searchAddress/parse.js +196 -0
package/src/searchAddress/search.js +184 -0
package/src/searchAddress/searchGazetteer.js +52 -0
package/src/searchAddress/showGeographicIdentifier.js +20 -0
package/src/searchAddress/types.js +17 -0
package/test/.eslintrc +7 -0
package/test/crs.test.js +109 -0
package/test/layer/geojson/index.test.js +133 -0
package/test/layer/geojson/style.test.js +46 -0
package/test/layer/lib.test.js +83 -0
package/test/layer/oaf.test.js +245 -0
package/test/layer/resources/oafFeatures.js +105 -0
package/test/layer/resources/wfsFeatures.js +26 -0
package/test/layer/resources/wfsFilter.js +17 -0
package/test/layer/terrain.test.js +106 -0
package/test/layer/tileset.test.js +116 -0
package/test/layer/vector.test.js +76 -0
package/test/layer/vectorBase.test.js +48 -0
package/test/layer/wfs.test.js +388 -0
package/test/layer/wms.test.js +256 -0
package/test/lib/coordsToPairs.test.js +9 -0
package/test/lib/getInitialLayers.test.js +28 -0
package/test/lib/oafUtil.test.js +24 -0
package/test/lib/setBackgroundImage.test.js +49 -0
package/test/lib/wfsUtil.test.js +28 -0
package/test/lib/zoomTo.test.js +74 -0
package/test/map.test.js +258 -0
package/test/mapView.test.js +59 -0
package/test/rawLayerList.test.js +48 -0
package/test/searchAddress/gazetteerSearchResults/address.js +175 -0
package/test/searchAddress/gazetteerSearchResults/district.js +71 -0
package/test/searchAddress/gazetteerSearchResults/houseNumber.js +32 -0
package/test/searchAddress/gazetteerSearchResults/index.js +19 -0
package/test/searchAddress/gazetteerSearchResults/parcel.js +44 -0
package/test/searchAddress/gazetteerSearchResults/street.js +46 -0
package/test/searchAddress/gazetteerSearchResults/streetKey.js +51 -0
package/test/searchAddress/gazetteerUrl.test.js +22 -0
package/test/searchAddress/parse.test.js +110 -0
package/test/searchAddress/search.test.js +150 -0
package/test/searchAddress/searchGazetteer.test.js +58 -0
package/test/searchAddress/showGeographicIdentifier.test.js +22 -0

package/example/config/portal.json ADDED Viewed

@@ -0,0 +1,35 @@
+{
+  "target": "map-div-id",
+  "epsg": "EPSG:25832",
+  "namedProjections": [
+    ["EPSG:31467", "+title=Bessel/Gauß-Krüger 3 +proj=tmerc +lat_0=0 +lon_0=9 +k=1 +x_0=3500000 +y_0=0 +ellps=bessel +datum=potsdam +units=m +no_defs"],
+    ["EPSG:25832", "+title=ETRS89/UTM 32N +proj=utm +zone=32 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs"],
+    ["EPSG:8395", "+title=ETRS89/Gauß-Krüger 3 +proj=tmerc +lat_0=0 +lon_0=9 +k=1 +x_0=3500000 +y_0=0 +ellps=GRS80 +datum=GRS80 +units=m +no_defs"],
+    ["EPSG:4326", "+title=WGS 84 (long/lat) +proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs"]
+  ],
+  "extent": [510000.0, 5850000.0, 625000.4, 6000000.0],
+  "options": [
+    { "resolution": 264.583190458, "scale": 1000000, "zoomLevel": 0 },
+    { "resolution": 132.291595229, "scale": 500000, "zoomLevel": 1 },
+    { "resolution": 66.14579761460263, "scale": 250000, "zoomLevel": 2 },
+    { "resolution": 26.458319045841044, "scale": 100000, "zoomLevel": 3 },
+    { "resolution": 15.874991427504629, "scale": 60000, "zoomLevel": 4 },
+    { "resolution": 10.583327618336419, "scale": 40000, "zoomLevel": 5 },
+    { "resolution": 5.2916638091682096, "scale": 20000, "zoomLevel": 6 },
+    { "resolution": 2.6458319045841048, "scale": 10000, "zoomLevel": 7 },
+    { "resolution": 1.3229159522920524, "scale": 5000, "zoomLevel": 8 },
+    { "resolution": 0.6614579761460262, "scale": 2500, "zoomLevel": 9 },
+    { "resolution": 0.2645831904584105, "scale": 1000, "zoomLevel": 10 },
+    { "resolution": 0.13229159522920521, "scale": 500, "zoomLevel": 11 }
+  ],
+  "startResolution": 132.291595229,
+  "startCenter": [565874, 5934140],
+  "units": "m",
+  "layerConf": "",
+  "layers": [
+    {
+      "id": "1001"
+    }
+  ],
+  "cesiumLib":"https://geoportal-hamburg.de/mastercode/cesium/1_88/Cesium.js"
+}

package/example/config/services.json ADDED Viewed

@@ -0,0 +1,79 @@
+[
+  {
+    "id": "1001",
+    "typ": "WMS",
+    "name": "WebAtlasDe",
+    "url": "https://sg.geodatenzentrum.de/wms_webatlasde__54a30b0f-b92f-34ba-39c0-3af32cfa13d6",
+    "format": "image/png",
+    "version": "1.3.0",
+    "layers": "webatlasde",
+    "transparent": true,
+    "singleTile": false,
+    "tilesize": 256,
+    "gutter": 0,
+    "minScale": 1,
+    "maxScale": 200
+  },
+  {
+    "id" : "1002",
+    "name" : "Krankenhäuser",
+    "url" : "https://geodienste.hamburg.de/HH_WMS_Krankenhaeuser",
+    "typ" : "WMS",
+    "layers" : "krankenhaeuser",
+    "format" : "image/png",
+    "version" : "1.3.0",
+    "singleTile" : false,
+    "transparent" : true,
+    "transparency" : 0,
+    "urlIsVisible" : true,
+    "tilesize" : 512
+  },
+  {
+    "id" : "2001",
+    "typ" : "GeoJSON",
+    "name" : "Landesgrenze Hamburg",
+    "url" : "https://geoportal-hamburg.de/lgv-config/landesgrenze_hh.json"
+  },
+  {
+    "id" : "3001",
+    "name" : "Bauwerke",
+    "url" : "https://geodienste.hamburg.de/HH_WFS_Geotourismus",
+    "typ" : "WFS",
+    "featureType" : "bauwerke",
+    "outputFormat" : "XML",
+    "version" : "1.1.0",
+    "featureNS" : "http://www.deegree.org/app"
+ },
+ {
+  "id" : "4001",
+  "name" : "Gelaende",
+  "url" : "https://daten-hamburg.de/gdi3d/datasource-data/Gelaende ",
+  "typ" : "Terrain3D",
+  "cesiumTerrainProviderOptions" : {
+     "requestVertexNormals" : true
+   }
+ },
+  {
+  "id" : "4002",
+  "name" : "Gebäude LoD2",
+  "url" : "https://daten-hamburg.de/gdi3d/datasource-data/LoD2",
+  "typ" : "TileSet3D",
+  "cesium3DTilesetOptions" : {
+     "maximumScreenSpaceError" : 6
+    }
+  },
+    {
+        "id": "5001",
+        "name": "Schulen",
+        "url": "https://api.hamburg.de/datasets/v1/schulen",
+        "collection" : "staatliche_schulen",
+        "typ": "OAF",
+        "bbox": "",
+        "bboxCrs": "",
+        "datetime": "",
+        "crs": "EPSG:25832",
+        "params": {
+            "anzahl_schueler": ">1000"
+        }
+    }
+]

package/example/index.html ADDED Viewed

@@ -0,0 +1,27 @@
+<!DOCTYPE html>
+<html>
+    <!-- this is a test page for the usage of MPAPI -->
+    <head>
+        <meta charset="utf-8">
+        <title>Masterportal API Example</title>
+        <link rel="stylesheet" href="style.scss">
+    </head>
+    <body>
+        <div class="mock-body">
+            <div class="mock-content">
+                <p>
+                    The example page is meant to simulate an actual website using the Masterportal-API in 2D and 3D. Use this page during development to see your changes live.
+                </p>
+                <input id="enable" type="button" value="2D/3D" />
+                <input id="layer-visibility" type="button" style="display: none;" value="Hintergrundkarte ausblenden" />
+                <div class="map-background">
+                    <!-- map is supposed to render itself in this div -->
+                    <div id="map-div-id"></div>
+                    <div id="controls"></div>
+                </div>
+            </div>
+        </div>
+        <script type="module" src="./index.js"></script>
+    </body>
+</html>

package/example/index.js ADDED Viewed

@@ -0,0 +1,210 @@
+import "ol/ol.css";
+import {Style, Stroke, Fill, Icon} from "ol/style.js";
+import * as mpapi from "../src";
+import mapsAPI from "../src/maps/api.js";
+import {getLayerWhere} from "../src/rawLayerList";
+import services from "./config/services.json";
+import portalConfig from "./config/portal.json";
+import localGeoJSON from "./config/localGeoJSON.js";
+import {load3DScript} from "../src/lib/load3DScript";
+//* Add elements to window to play with API in console
+window.mpapi = {
+    ...mpapi,
+    map2D: null,
+    map: null
+};
+// */
+//* Cleans up map before it is re-rendered (happens on every save during dev mode)
+document.getElementById(portalConfig.target).innerHTML = "";
+// add a click-listener to button, that creates a 3D-map on click
+document.getElementById("enable").addEventListener("click", function () {
+    if (window.mpapi.map2D === null) {
+        window.mpapi.map2D = window.mpapi.map;
+    }
+    if (window.mpapi.map.mapMode === "3D") {
+        window.mpapi.map.setEnabled(false);
+        window.mpapi.map = window.mpapi.map2D;
+        document.getElementById("layer-visibility").style.display = "none";
+        ["1001", "2001", "2002", "1002", "3001", "5001"].forEach(id => window.mpapi.map.addLayer(id));
+    }
+    else {
+        const lib = portalConfig.cesiumLib ? portalConfig.cesiumLib : "https://geoportal-hamburg.de/mastercode/cesium/1_88/Cesium.js";
+        document.getElementById("layer-visibility").style.display = "block";
+        load3DScript(lib, function Loaded3DCallback () {
+            let terrainLayer = null, tilesetLayer = null;
+            const toRemove = ["2001", "2002", "1002", "3001", "5001"];
+            layers2D.forEach(layer => {
+                const layerId = layer?.id || layer?.values_?.id;
+                if(toRemove.find(id => id === layerId)){
+                    map2D.removeLayer(layer);
+                }
+            });
+            const settings3D = {
+                    "map2D": window.mpapi.map2D
+                },
+                map3D = mapsAPI.map.createMap(settings3D, "3D"),
+                rawLayerTerrain = getLayerWhere({id: "4001"}),
+                rawLayerTileset = getLayerWhere({id: "4002"}),
+                scene = map3D.getCesiumScene();
+             //set some options to Cesium scene
+             scene.globe.enableLighting = true;
+             scene.globe.tileCacheSize = 20;
+             scene.globe.maximumScreenSpaceError =2;
+             scene.fxaa = true;
+             scene.highDynamicRange = false;
+             scene.pickTranslucentDepth = true;
+            window.mpapi.map = map3D;
+            tilesetLayer = new mpapi.Tileset(rawLayerTileset, window.mpapi.map);
+            tilesetLayer.setVisible(true, window.mpapi.map);
+            window.mpapi.map.setEnabled(true);
+            terrainLayer = mpapi.terrain.createLayer(rawLayerTerrain, window.mpapi.map);
+            terrainLayer.setVisible(true, rawLayerTerrain, window.mpapi.map);
+        });
+    }
+});
+// add a click-listener to button, that hides background layer in 3d
+document.getElementById("layer-visibility").addEventListener("click", function () {
+    map2D.getLayers().forEach(layer => {
+        map2D.removeLayer(layer);
+    });
+});
+//* Fake service that holds client-side prepared geojson; also nice to test automatic transformation since data is in WGS 84
+// eslint-disable-next-line no-unused-vars
+const hamburgServicesUrl = "http://geoportal-hamburg.de/lgv-config/services-internet.json",
+    localService = {
+        id: "2002",
+        typ: "GeoJSON",
+        features: localGeoJSON
+    },
+    config = {
+        ...portalConfig,
+        layerConf: services
+    },
+    map2D = mapsAPI.map.createMap(config, "2D"),
+    layers2D = [];
+services.push(localService);
+// */
+//* geojson styling function call to override default styling and special wfs styling
+mpapi.geojson.setCustomStyles({
+    MultiPolygon: new Style({
+        stroke: new Stroke({
+            width: 2,
+            color: "#000000"
+        }),
+        fill: new Fill({
+            color: "#FFFFFF55"
+        })
+    })
+});
+// eslint-disable-next-line
+const styleWfs = function (feature, resolution) {
+    const icon = new Style({
+        image: new Icon({
+            src: "https://img.icons8.com/windows/50/000000/building.png",
+            scale: 0.5,
+            opacity: 1
+        })
+    });
+    return [icon];
+};
+services.find(({id}) => id === "3001").style = styleWfs;
+// */
+// eslint-disable-next-line
+const styleOaf = function (feature, resolution) {
+    const icon = new Style({
+        image: new Icon({
+            src: "https://geodienste.hamburg.de/lgv-config/img/gymnasien.svg",
+            scale: 0.5,
+            opacity: 1
+        })
+    });
+    return [icon];
+};
+services.find(({id}) => id === "5001").style = styleOaf;
+//* SYNCHRONOUS EXAMPLE: layerConf is known
+window.mpapi.map = map2D;
+["2001", "2002", "1002", "3001", "5001"].forEach(id => window.mpapi.map.addLayer(id));
+map2D.getLayers().forEach(layer => {
+    layers2D.push(layer);
+});
+// */
+/* ASYNCHRONOUS EXAMPLE 1: work with layerConf callback
+document.getElementById("enable").style.display = "none";
+mpapi.rawLayerList.initializeLayerList(
+    hamburgServicesUrl,
+    conf => {
+        window.mpapi.map = mapsAPI.map.createMap({
+            ...portalConfig,
+            layerConf: conf,
+            layers: null
+        }, "2D");
+        ["6357", "6074"].forEach(
+            id => window.mpapi.map.addLayer(id)
+        );
+    }
+);
+//*/
+/* ASYNCHRONOUS EXAMPLE 2: work with createMap callback
+document.getElementById("enable").style.display = "none";
+window.mpapi.map = mapsAPI.map.createMap(
+    {...portalConfig, layerConf: hamburgServicesUrl, layers: [
+        { id: "6357" },
+        { id: "453", transparency: 50 }
+    ]}, "2D",
+    {
+        callback: () =>
+            ["6074"].forEach(
+                id => window.mpapi.map.addLayer(id)
+            )
+    }
+);
+//*/
+/* SEARCH FUNCTION EXAMPLE
+// You may e.g. copy this code to the browser's console to run a search.
+window.mpapi.search("Eiffe",  {
+    map: window.mpapi.map,
+    zoom: true,
+    zoomToParams: {duration: 1000, maxZoom: 8},
+    searchStreets: true
+}).then(x => console.log(x)).catch(e => console.error(e))
+window.mpapi.search("Mümmelmannsberg 72",  {
+    map: window.mpapi.map,
+    zoom: true,
+    zoomToParams: {duration: 1000, maxZoom: 8},
+    searchAddress: true
+}).then(x => console.log(x)).catch(e => console.error(e))
+//*/

package/example/style.scss ADDED Viewed

@@ -0,0 +1,59 @@
+/* CSS for example page. Do not manipulate map itself here, has no effect on prod. */
+html, body {
+    display: flex;
+    flex-direction: column;
+    margin: 0;
+    height: 100%;
+    font-family: sans-serif;
+    .mock-body {
+        display: flex;
+        flex-direction: row;
+        flex-wrap: nowrap;
+        height: 100%;
+        .mock-content {
+            padding: 1em;
+            color: black;
+            background: #E0E0E0;
+            flex-grow: 1;
+            display: flex;
+            flex-direction: column;
+            .content-mock {
+                padding: 0.2em;
+            }
+        }
+        /* Not part of MPAPI, but really nice if no background image is configured. */
+        .map-background {
+            background: #22222222;
+            flex-grow: 1;
+            #map-div-id {
+                /* map container needs a defined height */
+                height: 100%;
+            }
+            #controls {
+                right: 15px;
+                top: 160px;
+                padding: 10px;
+                text-align: right;
+                position: absolute;
+                z-index: 50;
+                opacity: 0.9;
+                background-color: transparent;
+                input:first-child {
+                    font-size: 17px;
+                    margin-top: 4px;
+                    padding: 6px 6px 6px 6px;
+                    font-family: "MasterPortalFont Bold", "Arial Narrow", Arial, sans-serif;
+                    color: #f3f3f3;
+                    background-color: #E10019;
+                    box-shadow: 0 6px 12px rgb(0 0 0 / 18%);
+                }
+            }
+        }
+    }
+}

package/jest.config.js ADDED Viewed

@@ -0,0 +1,18 @@
+/* eslint-env node */
+module.exports = {
+    /** ol prints errors without HTMLCanvasElement being available in test environment */
+    "setupFiles": ["jest-canvas-mock"],
+    /** node_modules are usually ignored by babel-jest, but ol is published in ES6 */
+    "transformIgnorePatterns": ["/node_modules/(?!(ol|olcs|ol-mapbox-style|geotiff)/).*/"],
+    /** only consider files in src/ for coverage */
+    "collectCoverageFrom": ["src/**/*.js"],
+    /** coverage reporters */
+    "coverageReporters": ["json", "lcov", "text", "clover", "cobertura"],
+    /** mapping svg to string representation since jest can't handle svg */
+    "moduleNameMapper": {
+        "marker.svg": "<rootDir>/public/stringMarker.js"
+    },
+    "testEnvironment": "jsdom",
+    "setupFilesAfterEnv": ["./jest.setup.js"],
+    "verbose": true
+};

package/jest.setup.js ADDED Viewed

@@ -0,0 +1,5 @@
+import "regenerator-runtime/runtime";
+window.URL.createObjectURL = function () {
+    // empty
+};

package/jsdoc.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+    "tags": {
+        "allowUnknownTags": true,
+        "dictionaries": ["jsdoc", "closure"]
+    },
+    "source": {
+        "includePattern": ".+\\.js(doc|x)?$",
+        "excludePattern": ""
+    },
+    "plugins": [],
+    "templates": {
+        "cleverLinks": false,
+        "monospaceLinks": false
+    }
+}

package/package.json ADDED Viewed

@@ -0,0 +1,62 @@
+{
+  "name": "@masterportal/masterportalapi",
+  "author": "Implementierungspartnerschaft Masterportal <info@masterportal.org> (https://www.masterportal.org)",
+  "version": "2.1.1",
+  "license": "MIT",
+  "description": "Basic functions of the Masterportal as api",
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/geowerkstatt-hamburg/masterportalapi.git"
+  },
+  "main": "src/index.js",
+  "scripts": {
+    "test": "jest .test.js --config ./jest.config.js --collectCoverage",
+    "test:trace": "node --trace-warnings node_modules/jest/bin/jest.js ./test/layer/wfs.test.js --config ./jest.config.js",
+    "test:watch": "jest .test.js --config ./jest.config.js --watch",
+    "example": "parcel example/index.html",
+    "generate-jsdoc": "jsdoc ./src -r -d ./docs/ -R ./README.md -c jsdoc.json",
+    "prePushHook": "eslint --max-warnings 0 \"./**/*.js\" && npm run test",
+    "prepare": "husky install"
+  },
+  "dependencies": {
+    "core-js": "^3.16.1",
+    "ol": "6.13.0",
+    "olcs": "^2.13.0",
+    "proj4": "^2.7.5",
+    "xml2js": "^0.4.23"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.16.7",
+    "@babel/plugin-transform-modules-commonjs": "^7.16.8",
+    "@parcel/transformer-sass": "^2.2.0",
+    "buffer": "^6.0.3",
+    "canvas": "^2.8.0",
+    "eslint": "^7.32.0",
+    "events": "^3.3.0",
+    "husky": "^7.0.1",
+    "jest": "^27.4.0",
+    "jest-canvas-mock": "^2.3.1",
+    "jsdoc": "^3.6.7",
+    "parcel": "^2.2.0",
+    "process": "^0.11.10",
+    "regenerator-runtime": "0.13.9",
+    "sass": "^1.37.5",
+    "stream-browserify": "^3.0.0",
+    "timers-browserify": "^2.0.12"
+  },
+  "peerDependencies": {
+    "cesium": "^1.88.0"
+  },
+  "engines": {
+    "node": "^16.13.2",
+    "npm": "^8.1.2"
+  },
+  "homepage": "https://bitbucket.org/geowerkstatt-hamburg/masterportalapi#readme",
+  "directories": {
+    "example": "example",
+    "test": "test"
+  },
+  "bugs": {
+    "url": "https://bitbucket.org/geowerkstatt-hamburg/masterportalapi/issues"
+  }
+}

package/public/marker.svg ADDED Viewed

	@@ -0,0 +1 @@
1	+ <svg width="23" height="32" viewBox="0 0 30 43" xmlns="http://www.w3.org/2000/svg"><title>DB6C494E-88E8-49F1-89CE-97CBEC3A5240</title><path d="M14.584 1C7.101 1 1 7.101 1 14.584c0 8.103 7.865 20.448 11.63 25.93a2.36 2.36 0 0 0 3.908 0c3.766-5.482 11.63-17.922 11.63-25.93C28.168 7.054 22.068 1 14.584 1z" stroke="#FFF" stroke-width="2" fill="#005CA9" fill-rule="nonzero"/></svg>

package/public/stringMarker.js ADDED Viewed

@@ -0,0 +1,5 @@
+/**
+ * marker.svg as URI. Jest uses this instead since it can't handle SVG files.
+ * @ignore
+ */
+export default "data:image/svg+xml,%3Csvg%20width%3D%2223%22%20height%3D%2232%22%20viewBox%3D%220%200%2030%2043%22%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%3E%3Ctitle%3EDB6C494E-88E8-49F1-89CE-97CBEC3A5240%3C%2Ftitle%3E%3Cpath%20d%3D%22M14.584%201C7.101%201%201%207.101%201%2014.584c0%208.103%207.865%2020.448%2011.63%2025.93a2.36%202.36%200%200%200%203.908%200c3.766-5.482%2011.63-17.922%2011.63-25.93C28.168%207.054%2022.068%201%2014.584%201z%22%20stroke%3D%22%23FFF%22%20stroke-width%3D%222%22%20fill%3D%22%23005CA9%22%20fill-rule%3D%22nonzero%22%2F%3E%3C%2Fsvg%3E%0A";

package/src/crs.js ADDED Viewed

@@ -0,0 +1,122 @@
+import proj4 from "proj4";
+import * as Proj from "ol/proj.js";
+import {register} from "ol/proj/proj4.js";
+import defaults from "./defaults";
+/**
+ * Creates an alias for the srsName.
+ * This is necessary for WFS from geoserver.org.
+ * @param {string} epsgCode used epsg code in the mapView
+ * @returns {void}
+ */
+function addAliasForWFSFromGeoserver (epsgCode) {
+    const epsgCodeNumber = epsgCode.split(":")[1];
+    proj4.defs("http://www.opengis.net/gml/srs/epsg.xml#" + epsgCodeNumber, proj4.defs(epsgCode));
+    register(proj4);
+}
+/**
+ * Returns the proj4 projection definition for a registered name.
+ * @param {string} name - projection name as written in [0] position of namedProjections
+ * @returns {(object|undefined)} proj4 projection object or undefined
+ */
+export function getProjection (name) {
+    return proj4.defs(name);
+}
+/**
+ * The configured named projections and proj4 have to be registered initially.
+ * @param {string[]} [namedProjections=[
+        ["EPSG:25832", "+proj=utm +zone=32 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs"]
+    ]] - projection name, projection definition string
+ * @returns {undefined}
+ */
+export function registerProjections (namedProjections = defaults.namedProjections) {
+    proj4.defs(namedProjections);
+    register(proj4);
+    namedProjections.forEach(projection => {
+        Proj.addProjection(Proj.get(projection[0]));
+        addAliasForWFSFromGeoserver(projection[0]);
+        getProjection(projection[0]).masterportal = true;
+    });
+}
+/**
+ * Returns all known projections.
+ * @returns {object[]} array of projection objects with their name added
+ */
+export function getProjections () {
+    const projections = Object
+        .keys(proj4.defs)
+        .map(name => Object.assign(proj4.defs(name), {name}));
+    // return no duplicates and only the projections which are registred with masterportal=true
+    return projections.filter(function (projection, index, self) {
+        return index === self.indexOf(projection) && projection.masterportal === true;
+    });
+}
+/**
+ * Returns the currently active projection's name of a map's view.
+ * @param {ol.Map} map - map to get projection of
+ * @returns {string} active projection name of map
+ */
+export function getMapProjection (map) {
+    return map.getView().getProjection().getCode();
+}
+/**
+ * Resolves a string to a projection object; everything else is returned as-is.
+ * If a string can not be resolved, returns undefined.
+ * @param {(string|object)} projection - projection name or projection
+ * @returns {(object|undefined)} proj4 projection or undefined or parameter
+ */
+function getProj4Projection (projection) {
+    return typeof projection === "string"
+        ? getProjection(projection)
+        : projection;
+}
+/**
+ * Transforms a given point from a source to a target projection.
+ * @param {(string|object)} sourceProjection - projection name or projection of point
+ * @param {(string|object)} targetProjection - projection name or projection to project point to
+ * @param {number[]} point - point to project
+ * @returns {number[]|undefined} transformed point
+ */
+export function transform (sourceProjection, targetProjection, point) {
+    const source = getProj4Projection(sourceProjection),
+        target = getProj4Projection(targetProjection);
+    if (source && target && point) {
+        return proj4(source, target, point);
+    }
+    console.error(`Cancelled coordinate transformation with invalid parameters: ${sourceProjection}; ${targetProjection}; ${point}`);
+    return undefined;
+}
+/**
+ * Projects a point to the given map.
+ * @param {ol.Map} map - map to project to
+ * @param {(string|object)} sourceProjection - projection name or projection of point
+ * @param {number[]} point - point to project
+ * @returns {number[]|undefined} new point or undefined
+ */
+export function transformToMapProjection (map, sourceProjection, point) {
+    return transform(sourceProjection, getMapProjection(map), point);
+}
+/**
+ * Projects a point from the given map.
+ * @param {ol.Map} map - map to project from, and point must be in map's projection
+ * @param {(string|object)} targetProjection - projection name or projection to project to
+ * @param {number[]} point - point to project
+ * @returns {(number[]|undefined)} new point or undefined
+ */
+export function transformFromMapProjection (map, targetProjection, point) {
+    return transform(getMapProjection(map), targetProjection, point);
+}