@masterportal/masterportalapi 2.1.1

package/test/searchAddress/gazetteerSearchResults/houseNumber.js

@@ -0,0 +1,32 @@
+// https://geodienste.hamburg.de/HH_WFS_GAGES?service=WFS&request=GetFeature&version=2.0.0&StoredQuery_ID=HausnummernZuStrasse&strassenname=Pflugacker
+export default `<?xml version='1.0' encoding='UTF-8'?>
+<wfs:FeatureCollection xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 http://schemas.opengis.net/wfs/2.0/wfs.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd http://www.hamburg.de/namespaces/gages https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=DescribeFeatureType&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;TYPENAME=gages:Hauskoordinaten&amp;NAMESPACES=xmlns(gages,http%3A%2F%2Fwww.hamburg.de%2Fnamespaces%2Fgages)" xmlns:wfs="http://www.opengis.net/wfs/2.0" timeStamp="2018-12-17T13:00:52Z" xmlns:gml="http://www.opengis.net/gml/3.2" numberMatched="unknown" numberReturned="0">
+<!--NOTE: numberReturned attribute should be 'unknown' as well, but this would not validate against the current version of the WFS 2.0 schema (change upcoming). See change request (CR 144): https://portal.opengeospatial.org/files?artifact_id=43925.-->
+<wfs:member>
+    <gages:Hauskoordinaten xmlns:gages="http://www.hamburg.de/namespaces/gages" gml:id="HH_H_256224167">
+    <iso19112:geographicIdentifier xmlns:iso19112="http://www.opengis.net/iso19112">Pflugacker 11a, 22523  Hamburg(OT Eidelstedt)</iso19112:geographicIdentifier>
+    <iso19112:geographicExtent xmlns:iso19112="http://www.opengis.net/iso19112">
+        <gmd:EX_BoundingPolygon xmlns:gmd="http://www.isotc211.org/2005/gmd">
+        <gmd:polygon>
+            <gml:Polygon gml:id="HH_H_256224167_ISO19112_GEOGRAPHICEXTENT" srsName="urn:ogc:def:crs:EPSG::25832">
+            <gml:exterior>
+                <gml:LinearRing>
+                <gml:posList>559562.466 5940928.639 559562.466 5940978.639 559612.466 5940978.639 559612.466 5940928.639 559562.466 5940928.639</gml:posList>
+                </gml:LinearRing>
+            </gml:exterior>
+            </gml:Polygon>
+        </gmd:polygon>
+        </gmd:EX_BoundingPolygon>
+    </iso19112:geographicExtent>
+    <iso19112:position xmlns:iso19112="http://www.opengis.net/iso19112">
+        <!--Inlined geometry 'HH_H_256224167_ISO19112_POSITION'-->
+        <gml:Point gml:id="HH_H_256224167_ISO19112_POSITION" srsName="urn:ogc:def:crs:EPSG::25832">
+        <gml:pos>559587.466 5940953.639</gml:pos>
+        </gml:Point>
+    </iso19112:position>
+    <iso19112:locationType xmlns:iso19112="http://www.opengis.net/iso19112" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=GetFeature&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById&amp;ID=HH_SILC_1#HH_SILC_1"/>
+    <dog:hausnummer xmlns:dog="http://www.adv-online.de/namespaces/adv/dog">11</dog:hausnummer>
+    <dog:hausnummernzusatz xmlns:dog="http://www.adv-online.de/namespaces/adv/dog">a</dog:hausnummernzusatz>
+    </gages:Hauskoordinaten>
+</wfs:member>
+</wfs:FeatureCollection>`;

package/test/searchAddress/gazetteerSearchResults/index.js

@@ -0,0 +1,19 @@
+import * as addressResults from "./address";
+import districtResult from "./district";
+import houseNumberResult from "./houseNumber";
+import parcelResult from "./parcel";
+import streetResult from "./street";
+import streetKeyResult from "./streetKey";
+
+/**
+ * Group of example HH gazetteer results for testing.
+ * @ignore
+ */
+export {
+    addressResults,
+    districtResult,
+    houseNumberResult,
+    parcelResult,
+    streetResult,
+    streetKeyResult
+};

package/test/searchAddress/gazetteerSearchResults/parcel.js

@@ -0,0 +1,44 @@
+// https://geodienste.hamburg.de/HH_WFS_GAGES?service=WFS&request=GetFeature&version=2.0.0&StoredQuery_ID=Flurstueck&gemarkung=0147&flurstuecksnummer=12561
+export default `<?xml version='1.0' encoding='UTF-8'?>
+<wfs:FeatureCollection xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 http://schemas.opengis.net/wfs/2.0/wfs.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd http://www.adv-online.de/namespaces/adv/dog https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=DescribeFeatureType&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;TYPENAME=dog:Flurstueckskoordinaten&amp;NAMESPACES=xmlns(dog,http%3A%2F%2Fwww.adv-online.de%2Fnamespaces%2Fadv%2Fdog)" xmlns:wfs="http://www.opengis.net/wfs/2.0" timeStamp="2018-12-17T14:30:50Z" xmlns:gml="http://www.opengis.net/gml/3.2" numberMatched="unknown" numberReturned="0">
+<!--NOTE: numberReturned attribute should be 'unknown' as well, but this would not validate against the current version of the WFS 2.0 schema (change upcoming). See change request (CR 144): https://portal.opengeospatial.org/files?artifact_id=43925.-->
+<wfs:member>
+    <dog:Flurstueckskoordinaten xmlns:dog="http://www.adv-online.de/namespaces/adv/dog" gml:id="HH_FLURSTUECK_227875032">
+    <iso19112:geographicIdentifier xmlns:iso19112="http://www.opengis.net/iso19112">02;0147;;12561;;</iso19112:geographicIdentifier>
+    <iso19112:geographicExtent xmlns:iso19112="http://www.opengis.net/iso19112">
+        <gmd:EX_BoundingPolygon xmlns:gmd="http://www.isotc211.org/2005/gmd">
+        <gmd:polygon>
+            <gml:Polygon gml:id="HH_FLURSTUECK_227875032_ISO19112_GEOGRAPHICEXTENT" srsName="urn:ogc:def:crs:EPSG::25832">
+            <gml:exterior>
+                <gml:LinearRing>
+                <gml:posList>566458.579 5928101.330 566458.579 5928151.330 566508.579 5928151.330 566508.579 5928101.330 566458.579 5928101.330</gml:posList>
+                </gml:LinearRing>
+            </gml:exterior>
+            </gml:Polygon>
+        </gmd:polygon>
+        </gmd:EX_BoundingPolygon>
+    </iso19112:geographicExtent>
+    <iso19112:position xmlns:iso19112="http://www.opengis.net/iso19112">
+        <!--Inlined geometry 'HH_FLURSTUECK_227875032_ISO19112_POSITION'-->
+        <gml:Point gml:id="HH_FLURSTUECK_227875032_ISO19112_POSITION" srsName="urn:ogc:def:crs:EPSG::25832">
+        <gml:pos>566483.579 5928126.330</gml:pos>
+        </gml:Point>
+    </iso19112:position>
+    <iso19112:gazetteer xmlns:iso19112="http://www.opengis.net/iso19112" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=GetFeature&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById&amp;ID=HH_SIGA_2#HH_SIGA_2"/>
+    <iso19112:locationType xmlns:iso19112="http://www.opengis.net/iso19112" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=GetFeature&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById&amp;ID=HH_SILC_9#HH_SILC_9"/>
+    <iso19112:parent xmlns:iso19112="http://www.opengis.net/iso19112">02;0147</iso19112:parent>
+    <dog:land>02</dog:land>
+    <dog:gemarkung>0147</dog:gemarkung>
+    <dog:flurstuecksnummer>12561</dog:flurstuecksnummer>
+    <dog:flurstueck_lang>12561</dog:flurstueck_lang>
+    <dog:flurstuecksflaeche>25</dog:flurstuecksflaeche>
+    <dog:status>0</dog:status>
+    <dog:regierungsbezirk>1</dog:regierungsbezirk>
+    <dog:kreis>16</dog:kreis>
+    <dog:gemeinde>137</dog:gemeinde>
+    <dog:verwaltungsart>Flurstueck</dog:verwaltungsart>
+    <dog:gemeindename>Wilhelmsburg</dog:gemeindename>
+    <dog:kreisname>Wilhelmsburg</dog:kreisname>
+    </dog:Flurstueckskoordinaten>
+</wfs:member>
+</wfs:FeatureCollection>`;

package/test/searchAddress/gazetteerSearchResults/street.js

@@ -0,0 +1,46 @@
+// https://geodienste.hamburg.de/HH_WFS_GAGES?service=WFS&request=GetFeature&version=2.0.0&StoredQuery_ID=findeStrasse&strassenname=bargkoppelweg
+export default `<?xml version='1.0' encoding='UTF-8'?>
+<wfs:FeatureCollection xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 http://schemas.opengis.net/wfs/2.0/wfs.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd http://www.adv-online.de/namespaces/adv/dog https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=DescribeFeatureType&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;TYPENAME=dog:Strassen&amp;NAMESPACES=xmlns(dog,http%3A%2F%2Fwww.adv-online.de%2Fnamespaces%2Fadv%2Fdog)" xmlns:wfs="http://www.opengis.net/wfs/2.0" timeStamp="2018-12-17T12:48:49Z" xmlns:gml="http://www.opengis.net/gml/3.2" numberMatched="unknown" numberReturned="0">
+<!--NOTE: numberReturned attribute should be 'unknown' as well, but this would not validate against the current version of the WFS 2.0 schema (change upcoming). See change request (CR 144): https://portal.opengeospatial.org/files?artifact_id=43925.-->
+<wfs:member>
+    <dog:Strassen xmlns:dog="http://www.adv-online.de/namespaces/adv/dog" gml:id="HH_STR_7610147">
+    <iso19112:geographicIdentifier xmlns:iso19112="http://www.opengis.net/iso19112">Bargkoppelweg (OT Rahlstedt) , Hamburg  (22145)</iso19112:geographicIdentifier>
+    <iso19112:geographicExtent xmlns:iso19112="http://www.opengis.net/iso19112">
+        <gmd:EX_BoundingPolygon xmlns:gmd="http://www.isotc211.org/2005/gmd">
+        <gmd:polygon>
+            <gml:Polygon gml:id="HH_STR_7610147_ISO19112_GEOGRAPHICEXTENT" srsName="urn:ogc:def:crs:EPSG::25832">
+            <gml:exterior>
+                <gml:LinearRing>
+                <gml:posList>576020.921 5941871.589 576777.652 5941871.589 576777.652 5942463.286 576020.921 5942463.286 576020.921 5941871.589</gml:posList>
+                </gml:LinearRing>
+            </gml:exterior>
+            </gml:Polygon>
+        </gmd:polygon>
+        </gmd:EX_BoundingPolygon>
+    </iso19112:geographicExtent>
+    <iso19112:position xmlns:iso19112="http://www.opengis.net/iso19112">
+        <!--Inlined geometry 'HH_STR_7610147_ISO19112_POSITION'-->
+        <gml:Point gml:id="HH_STR_7610147_ISO19112_POSITION" srsName="urn:ogc:def:crs:EPSG::25832">
+        <gml:pos>576399.286 5942167.438</gml:pos>
+        </gml:Point>
+    </iso19112:position>
+    <iso19112:position_strassenachse xmlns:iso19112="http://www.opengis.net/iso19112">
+        <!--Inlined geometry 'HH_STR_7610147_ISO19112_POSITION_STRASSENACHSE'-->
+        <gml:Point gml:id="HH_STR_7610147_ISO19112_POSITION_STRASSENACHSE" srsName="urn:ogc:def:crs:EPSG::25832">
+        <gml:pos>576096.393 5941919.653</gml:pos>
+        </gml:Point>
+    </iso19112:position_strassenachse>
+    <iso19112:locationType xmlns:iso19112="http://www.opengis.net/iso19112" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=GetFeature&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById&amp;ID=HH_SILC_2#HH_SILC_2"/>
+    <dog:land>02</dog:land>
+    <dog:strassenschluessel>02;5;18;526;0526;B0610</dog:strassenschluessel>
+    <dog:strassenname>Bargkoppelweg</dog:strassenname>
+    <dog:ortsteilname>OT 0526</dog:ortsteilname>
+    <dog:ortsteilname_normalisiert>OT0526</dog:ortsteilname_normalisiert>
+    <dog:gemeindename_normalisiert>OT0526</dog:gemeindename_normalisiert>
+    <dog:postOrtsteil>Rahlstedt</dog:postOrtsteil>
+    <dog:postOrtsteil_normalisiert>RAHLSTEDT</dog:postOrtsteil_normalisiert>
+    <dog:ortsnamePost>Hamburg</dog:ortsnamePost>
+    <dog:ortsnamePost_normalisiert>HAMBURG</dog:ortsnamePost_normalisiert>
+    </dog:Strassen>
+</wfs:member>
+</wfs:FeatureCollection>`;

package/test/searchAddress/gazetteerSearchResults/streetKey.js

@@ -0,0 +1,51 @@
+// https://geodienste.hamburg.de/HH_WFS_GAGES?service=WFS&request=GetFeature&version=2.0.0&StoredQuery_ID=findeStrassenSchluessel&strassenschluessel=A1270
+export default `<?xml version='1.0' encoding='UTF-8'?>
+<wfs:FeatureCollection xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 http://schemas.opengis.net/wfs/2.0/wfs.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd http://www.adv-online.de/namespaces/adv/dog https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=DescribeFeatureType&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;TYPENAME=dog:Strassen&amp;NAMESPACES=xmlns(dog,http%3A%2F%2Fwww.adv-online.de%2Fnamespaces%2Fadv%2Fdog)" xmlns:wfs="http://www.opengis.net/wfs/2.0" timeStamp="2018-12-17T13:04:04Z" xmlns:gml="http://www.opengis.net/gml/3.2" numberMatched="unknown" numberReturned="0">
+<!--NOTE: numberReturned attribute should be 'unknown' as well, but this would not validate against the current version of the WFS 2.0 schema (change upcoming). See change request (CR 144): https://portal.opengeospatial.org/files?artifact_id=43925.-->
+<wfs:member>
+    <dog:Strassen xmlns:dog="http://www.adv-online.de/namespaces/adv/dog" gml:id="HH_STR_7612101">
+    <iso19112:geographicIdentifier xmlns:iso19112="http://www.opengis.net/iso19112">Alte Marsch (OT Neugraben-Fischbek) , Hamburg  (21149)</iso19112:geographicIdentifier>
+    <iso19112:geographicExtent xmlns:iso19112="http://www.opengis.net/iso19112">
+        <gmd:EX_BoundingPolygon xmlns:gmd="http://www.isotc211.org/2005/gmd">
+        <gmd:polygon>
+            <gml:Polygon gml:id="HH_STR_7612101_ISO19112_GEOGRAPHICEXTENT" srsName="urn:ogc:def:crs:EPSG::25832">
+            <gml:exterior>
+                <gml:LinearRing>
+                <gml:posList>555024.929 5925215.300 555158.132 5925215.300 555158.132 5925409.413 555024.929 5925409.413 555024.929 5925215.300</gml:posList>
+                </gml:LinearRing>
+            </gml:exterior>
+            </gml:Polygon>
+        </gmd:polygon>
+        </gmd:EX_BoundingPolygon>
+    </iso19112:geographicExtent>
+    <iso19112:position xmlns:iso19112="http://www.opengis.net/iso19112">
+        <!--Inlined geometry 'HH_STR_7612101_ISO19112_POSITION'-->
+        <gml:Point gml:id="HH_STR_7612101_ISO19112_POSITION" srsName="urn:ogc:def:crs:EPSG::25832">
+        <gml:pos>555091.531 5925312.357</gml:pos>
+        </gml:Point>
+    </iso19112:position>
+    <iso19112:position_strassenachse xmlns:iso19112="http://www.opengis.net/iso19112">
+        <!--Inlined geometry 'HH_STR_7612101_ISO19112_POSITION_STRASSENACHSE'-->
+        <gml:Point gml:id="HH_STR_7612101_ISO19112_POSITION_STRASSENACHSE" srsName="urn:ogc:def:crs:EPSG::25832">
+        <gml:pos>555108.287 5925298.269</gml:pos>
+        </gml:Point>
+    </iso19112:position_strassenachse>
+    <iso19112:gazetteer xmlns:iso19112="http://www.opengis.net/iso19112" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=GetFeature&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById&amp;ID=HH_SIGA_2#HH_SIGA_2"/>
+    <iso19112:locationType xmlns:iso19112="http://www.opengis.net/iso19112" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://geodienste.hamburg.de/HH_WFS_GAGES?SERVICE=WFS&amp;VERSION=2.0.0&amp;REQUEST=GetFeature&amp;OUTPUTFORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&amp;STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById&amp;ID=HH_SILC_2#HH_SILC_2"/>
+    <dog:land>02</dog:land>
+    <dog:strassenschluessel>02;7;14;715;0715;A1270</dog:strassenschluessel>
+    <dog:strassenname>Alte Marsch</dog:strassenname>
+    <dog:strassenname_normalisiert>ALTEMARSCH</dog:strassenname_normalisiert>
+    <dog:strassenname_soundex>A435</dog:strassenname_soundex>
+    <dog:ortsteilname>OT 0715</dog:ortsteilname>
+    <dog:ortsteilname_normalisiert>OT0715</dog:ortsteilname_normalisiert>
+    <dog:gemeindename_normalisiert>OT0715</dog:gemeindename_normalisiert>
+    <dog:postleitzahl>21149</dog:postleitzahl>
+    <dog:postOrtsteil>Neugraben-Fischbek</dog:postOrtsteil>
+    <dog:postOrtsteil_normalisiert>NEUGRABENFISCHBEK</dog:postOrtsteil_normalisiert>
+    <dog:postleitzahl>21149</dog:postleitzahl>
+    <dog:ortsnamePost>Hamburg</dog:ortsnamePost>
+    <dog:ortsnamePost_normalisiert>HAMBURG</dog:ortsnamePost_normalisiert>
+    </dog:Strassen>
+</wfs:member>
+</wfs:FeatureCollection>`;

package/test/searchAddress/gazetteerUrl.test.js

@@ -0,0 +1,22 @@
+import {getGazetteerUrl, setGazetteerUrl} from "../../src/searchAddress";
+import defaults from "../../src/defaults";
+
+describe("searchAddress", function () {
+    describe("setGazetteerUrl/getGazetteerUrl", function () {
+        it("gazetteer url can be setted and getted, is initially default", function () {
+            const initialUrl = getGazetteerUrl();
+
+            expect(initialUrl).toEqual(defaults.gazetteerUrl);
+            setGazetteerUrl("test");
+            expect(getGazetteerUrl()).toEqual("test");
+            setGazetteerUrl(initialUrl);
+        });
+
+        it("setting gazetteer url with falsy value means not changing previous value", function () {
+            const initialUrl = getGazetteerUrl();
+
+            setGazetteerUrl(undefined);
+            expect(getGazetteerUrl()).toEqual(initialUrl);
+        });
+    });
+});

package/test/searchAddress/parse.test.js

@@ -0,0 +1,110 @@
+import * as gazetteerSearchResults from "./gazetteerSearchResults/index";
+
+import {parse} from "../../src/searchAddress/parse";
+import {searchTypes} from "../../src/searchAddress";
+
+describe("searchAddress", function () {
+    describe("parse", function () {
+        it("parses district results as expected", function (done) {
+            parse(searchTypes.DISTRICT, gazetteerSearchResults.districtResult)
+                .then(x => {
+                    expect(x[0].name).toBe("Barmbek-Nord");
+                    expect(x[0].type).toBe(searchTypes.DISTRICT);
+                    expect(x[0].properties.bundeslandname).toBe("Hamburg");
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "569569.732", "5939046.574"
+                    ]);
+
+                    expect(x[1].name).toBe("Barmbek-Süd");
+                    expect(x[1].type).toBe(searchTypes.DISTRICT);
+                    expect(x[1].properties.bundeslandname).toBe("Hamburg");
+                    expect(x[1].geometry.coordinates).toEqual([
+                        "568729.508", "5937017.649"
+                    ]);
+                    done();
+                });
+        });
+
+        it("parses street key results as expected", function (done) {
+            parse(searchTypes.STREET_KEY, gazetteerSearchResults.streetKeyResult)
+                .then(x => {
+                    expect(x[0].name).toBe("Alte Marsch");
+                    expect(x[0].type).toBe(searchTypes.STREET_KEY);
+                    expect(x[0].properties.postOrtsteil).toBe("Neugraben-Fischbek");
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "555108.287", "5925298.269"
+                    ]);
+                    done();
+                });
+        });
+
+        it("parses street results as expected", function (done) {
+            parse(searchTypes.STREET, gazetteerSearchResults.streetResult)
+                .then(x => {
+                    expect(x[0].name).toBe("Bargkoppelweg");
+                    expect(x[0].type).toBe(searchTypes.STREET);
+                    expect(x[0].properties.postOrtsteil).toBe("Rahlstedt");
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "576096.393", "5941919.653"
+                    ]);
+                    done();
+                });
+        });
+
+        it("parses parcel results as expected", function (done) {
+            parse(searchTypes.PARCEL, gazetteerSearchResults.parcelResult)
+                .then(x => {
+                    expect(x[0].name).toBe("0147/12561");
+                    expect(x[0].type).toBe(searchTypes.PARCEL);
+                    expect(x[0].properties.gemeindename).toBe("Wilhelmsburg");
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "566483.579", "5928126.330"
+                    ]);
+                    done();
+                });
+        });
+
+        it("parses houseNumber results as expected", function (done) {
+            parse(searchTypes.HOUSE_NUMBERS_FOR_STREET, gazetteerSearchResults.houseNumberResult)
+                .then(x => {
+                    expect(x[0].name).toBe("Pflugacker 11a");
+                    expect(x[0].type).toBe(searchTypes.HOUSE_NUMBERS_FOR_STREET);
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "559587.466", "5940953.639"
+                    ]);
+                    done();
+                });
+        });
+
+        it("parses address (with addition) results as expected", function (done) {
+            parse(searchTypes.ADDRESS_AFFIXED, gazetteerSearchResults.addressResults.adresseMitZusatz)
+                .then(x => {
+                    expect(x[0].name).toBe("Pflugacker 13b");
+                    expect(x[0].type).toBe(searchTypes.ADDRESS_AFFIXED);
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "559578.353", "5941044.732"
+                    ]);
+                    done();
+                });
+        });
+
+        it("parses address (without addition) results as expected", function (done) {
+            parse(searchTypes.ADDRESS_UNAFFIXED, gazetteerSearchResults.addressResults.adresseOhneZusatz)
+                .then(x => {
+                    expect(x[0].name).toBe("Bargkoppelweg 1");
+                    expect(x[0].type).toBe(searchTypes.ADDRESS_UNAFFIXED);
+                    expect(x[0].geometry.type).toBe("Point");
+                    expect(x[0].geometry.coordinates).toEqual([
+                        "576071.966", "5941920.455"
+                    ]);
+                    done();
+                });
+        });
+    });
+});

package/test/searchAddress/search.test.js

@@ -0,0 +1,150 @@
+import {search} from "../../src/searchAddress";
+import {searchTypes as types} from "../../src/searchAddress/types";
+
+// mock implementation for search gazetteer just returns example values by type and ignores search value
+jest.mock("../../src/searchAddress/searchGazetteer", () => {
+    // must disable this rule since jest.mock requires import within mock https://github.com/facebook/jest/issues/2567#issuecomment-271937555
+    /* eslint-disable global-require */
+    const {searchTypes} = require("../../src/searchAddress/types"),
+        {addressResults, districtResult, houseNumberResult, parcelResult, streetResult, streetKeyResult} = require("./gazetteerSearchResults");
+    /* eslint-enable global-require */
+
+    return {
+        searchGazetteer: jest.fn((type, value) => new Promise((resolve, reject) => {
+            const exampleResult = {
+                [searchTypes.PARCEL]: parcelResult,
+                [searchTypes.STREET]: streetResult,
+                [searchTypes.STREET_KEY]: streetKeyResult,
+                [searchTypes.HOUSE_NUMBERS_FOR_STREET]: houseNumberResult,
+                [searchTypes.DISTRICT]: districtResult,
+                [searchTypes.ADDRESS_AFFIXED]: addressResults.adresseMitZusatz,
+                [searchTypes.ADDRESS_UNAFFIXED]: addressResults.adresseOhneZusatz
+            }[type];
+
+            if (exampleResult) {
+                resolve(exampleResult);
+            }
+            else {
+                reject(`No test data for type/value '${type}/${value}'.`);
+            }
+        }))
+    };
+});
+
+import {searchGazetteer as mockedSearchGazetteer} from "../../src/searchAddress/searchGazetteer";
+
+describe("searchAddress", function () {
+    describe("search", function () {
+        it("rejects if missing configuration of what to search for", function (done) {
+            search("Pflugacker", {}).catch(e => {
+                expect(typeof e.error).toBe("string");
+                done();
+            });
+        });
+
+        it("rejects if string is below default minimum length", function (done) {
+            search("P", {searchStreets: true})
+                .catch(e => {
+                    expect(typeof e.error).toBe("string");
+                    done();
+                });
+        });
+
+        it("rejects if string is below defined length", function (done) {
+            search("Pflugacker", {minCharacters: 20, searchStreets: true})
+                .catch(e => {
+                    expect(typeof e.error).toBe("string");
+                    done();
+                });
+        });
+
+        it("forwards the expected type and string to the searchGazetteer method", function (done) {
+            jest.clearAllMocks(); // reset mock calls
+
+            const searches = [
+                    search("Address 7", {searchAddress: true}),
+                    search("Address 7b", {searchAddress: true}),
+                    search("Streetname", {searchStreets: true}),
+                    search("StreetnameAndHnrs", {searchStreets: true, searchHouseNumbers: true}),
+                    search("Districtname", {searchDistricts: true}),
+                    search("1234/1234", {searchParcels: true}),
+                    search("12345678", {searchParcels: true}),
+                    search("A12345", {searchStreetKey: true})
+                ],
+                abortController = new AbortController();
+
+            Promise.all(searches)
+                .then(results => {
+                    // order of calls may vary, hence using expect.arrayContaining
+                    const expected = [
+                        [types.ADDRESS_UNAFFIXED, ["Address", "7"], abortController],
+                        [types.ADDRESS_AFFIXED, ["Address", "7", "b"], abortController],
+                        [types.STREET, "Streetname", abortController],
+                        [types.STREET, "StreetnameAndHnrs", abortController],
+                        [types.HOUSE_NUMBERS_FOR_STREET, "Bargkoppelweg", abortController],
+                        [types.DISTRICT, "Districtname", abortController],
+                        [types.PARCEL, ["1234", "1234"], abortController],
+                        [types.PARCEL, ["1234", "5678"], abortController],
+                        [types.STREET_KEY, "A12345", abortController]
+                    ];
+
+                    expect(results[0]).toHaveLength(1);
+                    expect(results[1]).toHaveLength(1);
+                    expect(results[2]).toHaveLength(1);
+                    expect(results[3]).toHaveLength(2);
+                    expect(results[4]).toHaveLength(2);
+                    expect(results[5]).toHaveLength(1);
+                    expect(results[6]).toHaveLength(1);
+                    expect(results[7]).toHaveLength(1);
+                    expect(mockedSearchGazetteer.mock.calls).toHaveLength(9);
+                    expect(mockedSearchGazetteer.mock.calls).toEqual(expect.arrayContaining(expected));
+                    done();
+                })
+                .catch(e => console.error(e));
+        });
+
+        it("calls zoomTo if params indicate to zoom and there is exactly one result", function (done) {
+            const fitMock = jest.fn(),
+                zoomToParams = {x: 0};
+
+            search("Streetname", {
+                searchStreets: true,
+                zoom: true,
+                zoomToParams,
+                map: {
+                    getView: () => ({
+                        fit: fitMock
+                    })
+                }
+            })
+                .then(results => {
+                    expect(results).toHaveLength(1);
+                    expect(fitMock).toHaveBeenCalledWith(expect.any(Object), zoomToParams);
+                    done();
+                })
+                .catch(e => console.error(e));
+        });
+
+        it("does not call zoomTo if params indicate to zoom, but there is not exactly one result", function (done) {
+            const fitMock = jest.fn();
+
+            search("StreetnameAndHnrs", {
+                searchStreets: true,
+                searchHouseNumbers: true,
+                zoom: true,
+                zoomToParams: {x: 0},
+                map: {
+                    getView: () => ({
+                        fit: fitMock
+                    })
+                }
+            })
+                .then(results => {
+                    expect(results).toHaveLength(2);
+                    expect(fitMock).not.toHaveBeenCalled();
+                    done();
+                })
+                .catch(e => console.error(e));
+        });
+    });
+});

package/test/searchAddress/searchGazetteer.test.js

@@ -0,0 +1,58 @@
+import {encode, getIdQuery, searchGazetteer} from "../../src/searchAddress/searchGazetteer";
+import {searchTypes} from "../../src/searchAddress/types";
+import defaults from "../../src/defaults";
+
+describe("searchAddress", function () {
+    describe("encode", function () {
+        it("encodes a string or an array of strings for URi use", function () {
+            const a = "\"hello world\"",
+                arr = [a, a, a];
+
+            expect(encode(a)).toEqual("%22hello%20world%22");
+            expect(encode(arr)).toEqual([encode(a), encode(a), encode(a)]);
+        });
+    });
+
+    describe("getIdQuery", function () {
+        it("encodes given search phrase(s) and builds query fragment from it", function () {
+            expect(getIdQuery(searchTypes.STREET, "hello world")).toEqual("&StoredQuery_ID=findeStrasse&strassenname=*hello%20world");
+            expect(getIdQuery(searchTypes.DISTRICT, "hello world")).toEqual("&StoredQuery_ID=findeStadtteil&stadtteilname=hello%20world");
+            expect(getIdQuery(searchTypes.PARCEL, ["1 a", "1 b"])).toEqual("&StoredQuery_ID=Flurstueck&gemarkung=1%20a&flurstuecksnummer=1%20b");
+            expect(getIdQuery(searchTypes.STREET_KEY, "A12345")).toEqual("&StoredQuery_ID=findeStrassenSchluessel&strassenschluessel=A12345");
+            expect(getIdQuery(searchTypes.ADDRESS_AFFIXED, ["Street", "1", "b"])).toEqual("&StoredQuery_ID=AdresseMitZusatz&strassenname=Street&hausnummer=1&zusatz=b");
+            expect(getIdQuery(searchTypes.ADDRESS_UNAFFIXED, ["Street", "1"])).toEqual("&StoredQuery_ID=AdresseOhneZusatz&strassenname=Street&hausnummer=1");
+            expect(getIdQuery(searchTypes.HOUSE_NUMBERS_FOR_STREET, "Street")).toEqual("&StoredQuery_ID=HausnummernZuStrasse&strassenname=Street");
+        });
+    });
+
+    describe("searchGazetteer", function () {
+        const consoleError = console.error;
+
+        beforeEach(() => {
+            if (global.fetch) {
+                fetch.mockClear();
+            }
+        });
+
+        // to reset show error on load in console
+        afterEach(() => {
+            console.error = consoleError;
+        });
+
+        it("constructs an URL and requests it", async function () {
+            global.fetch = jest.fn().mockImplementationOnce(() => {
+                return new Promise((resolve) => {
+                    resolve({
+                        ok: true,
+                        status: 200,
+                        text: () => "Gazetteer Response"
+                    });
+                });
+            });
+
+            await searchGazetteer("district", "district name");
+
+            expect(fetch).toHaveBeenCalledWith(`${defaults.gazetteerUrl}&StoredQuery_ID=findeStadtteil&stadtteilname=district%20name`, {"signal": undefined, "timeout": 6000});
+        });
+    });
+});

package/test/searchAddress/showGeographicIdentifier.test.js

@@ -0,0 +1,22 @@
+import {setShowGeographicIdentifier, getShowGeographicIdentifier} from "../../src/searchAddress";
+import defaults from "../../src/defaults";
+
+describe("searchAddress", () => {
+    describe("setShowGeographicIdentifier/showGeographicIdentifier", () => {
+        it("showGeographicIdentifier url can be setted and getted, is initially default", () => {
+            const initialState = getShowGeographicIdentifier();
+
+            expect(initialState).toEqual(defaults.showGeographicIdentifier);
+            setShowGeographicIdentifier(true);
+            expect(getShowGeographicIdentifier()).toEqual(true);
+            setShowGeographicIdentifier(initialState);
+        });
+
+        it("setting showGeographicIdentifier with falsy value means not changing previous value", () => {
+            const initialState = getShowGeographicIdentifier();
+
+            setShowGeographicIdentifier(undefined);
+            expect(getShowGeographicIdentifier()).toEqual(initialState);
+        });
+    });
+});