@artsdatabanken/nbic-map-component 0.3.0 → 0.3.1

package/README.md

@@ -167,4 +167,32 @@ export class AppComponent implements AfterViewInit {
     height: 60vh;
     width: 100%;
 }
+```
+
+### Place search
+`map.searchPlaces(query, options?)` does a prefix search in [Geonorge stedsnavn](https://ws.geonorge.no/stedsnavn/v1/#/default/get_navn) straight from the browser and returns one `PlaceSearchResult` per spelling (Tromsø, Romsa and Tromssa are three results with the same `placeId`).
+
+- `zoomLevel` suits the place type (a church gets closer than a fjord) and is computed for this map's view, so it can be passed straight to `setZoom`.
+- `coordinates` are WGS84 `{ lat, lon }`.
+- Options: `signal`, `limit` (default 10, max 500), `fuzzy`, `municipalityNumbers`, `countyNumbers`.
+- Abort `signal` to cancel. The promise then rejects with an `AbortError`.
+
+The zoom per type lives in `src/core/place-search/place-zoom.ts`.
+
+Debounced search with RxJS:
+```ts
+const places$ = term$.pipe(
+  debounceTime(300),
+  distinctUntilChanged(),
+  switchMap((term) => new Observable<PlaceSearchResult[]>((subscriber) => {
+    const controller = new AbortController();
+    map.searchPlaces(term, { signal: controller.signal })
+      .then((places) => { subscriber.next(places); subscriber.complete(); }, (err) => subscriber.error(err));
+    return () => controller.abort();
+  })),
+);
+
+// on select
+map.setCenter(map.transformCoordsFrom([place.coordinates.lon, place.coordinates.lat], 'EPSG:4326', 'EPSG:25833'));
+map.setZoom(place.zoomLevel);
 ```

package/dist/index.cjs

@@ -145,6 +145,371 @@ var mapBounds = [
   }
 ];
 
+// src/core/place-search/place-zoom.ts
+var METERS_PER_PIXEL_AT_ZOOM_0 = 156543.03392804097;
+var PLACE_ZOOM = {
+  point: 17,
+  // ~1.2 km across: buildings, single structures
+  small: 15,
+  // ~5 km: small natural features, farms' surroundings, neighbourhoods
+  medium: 13,
+  // ~19 km: lakes, mountains, valleys, towns
+  large: 11.5,
+  // ~54 km: fjords, mountain areas, municipalities
+  region: 9,
+  // ~300 km: counties, sea areas
+  country: 6
+  // ~2 400 km
+};
+var DEFAULT_ZOOM_CLASS = "small";
+var TYPES_BY_CLASS = {
+  point: [
+    "Adressetilleggsnavn",
+    "Annen bygning for religionsut\xF8velse",
+    "Annen industri- og lagerbygning",
+    "Annen kulturdetalj",
+    "Badeplass",
+    "Barnehage",
+    "Boinstitusjon",
+    "Boligblokk",
+    "Bomstasjon",
+    "Borettslag",
+    "Bru",
+    "Bruk",
+    "Brygge",
+    "Busstasjon",
+    "Busstopp",
+    "Bygg for jordbruk, fiske og fangst",
+    "B\xE5ke",
+    "Campingplass",
+    "Dam",
+    "Eiendom",
+    "Eiendomsteig",
+    "Enebolig/mindre boligbygg",
+    "Fabrikk",
+    "Fengsel",
+    "Ferjekai",
+    "Fjell i dagen",
+    "Fjellheis",
+    "Fl\xF8tningsanlegg",
+    "Forn\xF8yelsespark",
+    "Forretningsbygg",
+    "Forsamlingshus/kulturhus",
+    "Forskningsstasjon",
+    "Foss",
+    "Fritidsbolig",
+    "Fyllplass",
+    "Fyrlykt",
+    "Fyrstasjon",
+    "Gammel bosettingsplass",
+    "Garasje/hangarbygg",
+    "Gard",
+    "Gjerde",
+    "Gravplass",
+    "Grensemerke",
+    "Grind",
+    "Grotte",
+    "Grustak/steinbrudd",
+    "Gr\xF8ft",
+    "Helikopterlandingsplass",
+    "Heller",
+    "Helseinstitusjon",
+    "Historisk bosetting",
+    "Holdeplass",
+    "Hotell",
+    "H\xF8l",
+    "Idrettsanlegg",
+    "Idrettshall",
+    "Jernbanebru",
+    "Jernstang",
+    "Jorde",
+    "Kai",
+    "Kilde",
+    "Kirke",
+    "Klopp",
+    "Kraftstasjon",
+    "Kultur-/messehall",
+    "Landingsplass",
+    "Lanterne",
+    "Lysb\xF8ye",
+    "Matrikkeladressenavn",
+    "Melkeplass",
+    "Milit\xE6rt bygg/anlegg",
+    "Mindre brukonstruksjon",
+    "Molo",
+    "Museum/galleri/bibliotek",
+    "Navnegard",
+    "Offersted",
+    "Oppdrettsanlegg",
+    "Overbygg",
+    "Overett",
+    "Park",
+    "Parkeringsplass",
+    "Pensjonat",
+    "Pytt",
+    "Rasteplass",
+    "R\xE5dhus",
+    "Serveringssted",
+    "Seter/st\xF8l",
+    "Setervoll",
+    "Severdighet",
+    "Sj\xF8merke med indirekte belysning",
+    "Sj\xF8varde",
+    "Skiheis",
+    "Skogholt",
+    "Skole",
+    "Skytebane",
+    "Sluse",
+    "Sm\xE5b\xE5thavn",
+    "Stake",
+    "Stasjon",
+    "Stein",
+    "Stryk",
+    "St\xF8",
+    "St\xF8ls-/setereiendom",
+    "Sva",
+    "Sykehus",
+    "Torg",
+    "Torvtak",
+    "Tuft",
+    "Turisthytte",
+    "TV-/radio- eller mobiltelefont\xE5rn",
+    "T\xF8mmervelte",
+    "Universitet/h\xF8gskole",
+    "Utsiktspunkt",
+    "Utstikker",
+    "Vad",
+    "Vaktstasjon/beredsskapsbygning",
+    "Vannstandsm\xE5ler",
+    "Vannverk",
+    "Varde",
+    "Vegbom",
+    "Vegkryss",
+    "Vegsving",
+    "\xD8yr"
+  ],
+  small: [
+    "Administrativ bydel",
+    "Adressenavn",
+    "Alpinanlegg",
+    "Ankringsplass",
+    "Annen terrengdetalj",
+    "Annen vanndetalj",
+    "Bakke",
+    "Bakke (Veg)",
+    "Bakke i sj\xF8",
+    "Bakketopp i sj\xF8",
+    "Bekk",
+    "Berg",
+    "Bergverk",
+    "Boligfelt",
+    "Botn",
+    "Bydel",
+    "B\xE5e",
+    "B\xE5e i sj\xF8",
+    "Del av innsj\xF8",
+    "Del av vann",
+    "Egg",
+    "Eid",
+    "Eid i sj\xF8",
+    "Elvemel",
+    "Elvesving",
+    "Eng",
+    "Fiskeplass i sj\xF8",
+    "Fjellkant",
+    "Fjellside",
+    "Fjelltopp i sj\xF8",
+    "Fjellvegg",
+    "Flyplass",
+    "Fonn",
+    "Friluftsomr\xE5de",
+    "Grend",
+    "Grunne",
+    "Grunne i sj\xF8",
+    "Grunnkrets",
+    "Gruppe av tjern",
+    "Hammar",
+    "Haug",
+    "Havn",
+    "Havnehage",
+    "Holme",
+    "Holme i sj\xF8",
+    "Holmegruppe i sj\xF8",
+    "Hylle",
+    "Hyttefelt",
+    "H\xF8yde",
+    "Industriomr\xE5de",
+    "Jernbanetunnel",
+    "Juv",
+    "Kabel",
+    "Kanal",
+    "Klakk i sj\xF8",
+    "Korallrev",
+    "Kraftgate (r\xF8rgate)",
+    "Krater",
+    "Li",
+    "Lon",
+    "Mo",
+    "Myr",
+    "Nes",
+    "Nes i sj\xF8",
+    "Nes ved elver",
+    "Oljeinstallasjon",
+    "Os",
+    "Rev i sj\xF8",
+    "Rygg",
+    "Sand",
+    "Senkning",
+    "Sj\xF8detalj",
+    "Skar",
+    "Skj\xE6r",
+    "Skj\xE6r i sj\xF8",
+    "Skog",
+    "Skredomr\xE5de",
+    "Slette",
+    "Sti",
+    "Strand",
+    "Strand i sj\xF8",
+    "Stup",
+    "Sund",
+    "Sund i sj\xF8",
+    "S\xF8kk",
+    "Taubane",
+    "Tettbebyggelse",
+    "Tettsteddel",
+    "Tjern",
+    "Topp",
+    "Traktorveg",
+    "Tunnel",
+    "Ur",
+    "Utmark",
+    "Vann",
+    "Vik",
+    "Vik i sj\xF8",
+    "V\xE5g i sj\xF8",
+    "V\xE5tmarksomr\xE5de",
+    "\xD8y",
+    "\xC5s"
+  ],
+  medium: [
+    "Allmenning",
+    "Annen administrativ inndeling",
+    "Banestrekning",
+    "Banke",
+    "By",
+    "Bygdelag (bygd)",
+    "Dal",
+    "Egg i sj\xF8",
+    "Elv",
+    "Farled/skipslei",
+    "Ferjestrekning",
+    "Fjell",
+    "Fjellovergang",
+    "Fjordmunning",
+    "Gass-/oljefelt i sj\xF8",
+    "Gruppe av vann",
+    "Halv\xF8y",
+    "Halv\xF8y i sj\xF8",
+    "Hei",
+    "Hylle i sj\xF8",
+    "Innsj\xF8",
+    "Isbre",
+    "Kraftledning",
+    "Landskapsomr\xE5de",
+    "Morenerygg i sj\xF8",
+    "Poststed",
+    "Ras i sj\xF8",
+    "Renne/Kl\xF8ft i sj\xF8",
+    "Rygg i sj\xF8",
+    "R\xF8rledning",
+    "Sadel i sj\xF8",
+    "Sj\xF8stykke",
+    "Skogomr\xE5de",
+    "Skolekrets",
+    "Skytefelt",
+    "Sokn",
+    "Statistisk tettsted",
+    "S\xF8kk i sj\xF8",
+    "Tettsted",
+    "Undersj\xF8isk vegg",
+    "Valgkrets",
+    "Vegstrekning",
+    "Verneomr\xE5de",
+    "Vulkan i sj\xF8",
+    "\xD8y i sj\xF8",
+    "\xD8ygruppe"
+  ],
+  large: [
+    "Banke i sj\xF8",
+    "Basseng i sj\xF8",
+    "Dalf\xF8re",
+    "Fjellkjede i sj\xF8",
+    "Fjellomr\xE5de",
+    "Fjord",
+    "Geologisk struktur",
+    "Havdyp",
+    "Iskuppel",
+    "Kommune",
+    "Plat\xE5 i sj\xF8",
+    "Reinbeitedistrikt",
+    "Sokkel i sj\xF8",
+    "Vidde",
+    "\xD8ygruppe i sj\xF8"
+  ],
+  region: ["Fylke", "Havomr\xE5de", "Havstr\xF8m", "Kontinentalsokkel", "Soneinndeling til havs"],
+  country: ["Nasjon"]
+};
+var CLASS_BY_TYPE = new Map(
+  Object.entries(TYPES_BY_CLASS).flatMap(
+    ([cls, types]) => types.map((t) => [t, cls])
+  )
+);
+function zoomClassForType(type) {
+  return CLASS_BY_TYPE.get(type.trim()) ?? DEFAULT_ZOOM_CLASS;
+}
+function metersPerPixelForType(type) {
+  return METERS_PER_PIXEL_AT_ZOOM_0 / 2 ** PLACE_ZOOM[zoomClassForType(type)];
+}
+
+// src/core/place-search/geonorge.ts
+var GEONORGE_NAVN_URL = "https://ws.geonorge.no/stedsnavn/v1/navn";
+var DEFAULT_LIMIT = 10;
+var MAX_LIMIT = 500;
+var REJECTED_CHARACTERS = /["?;%\\]/g;
+async function searchGeonorgePlaces(query, options = {}) {
+  options.signal?.throwIfAborted();
+  const term = query.replace(REJECTED_CHARACTERS, "").trim();
+  if (!term.replace(/\*/g, "")) return [];
+  const url = new URL(GEONORGE_NAVN_URL);
+  const params = url.searchParams;
+  params.set("sok", term.endsWith("*") ? term : `${term}*`);
+  params.set("utkoordsys", "4326");
+  params.set("treffPerSide", String(Math.min(Math.max(Math.trunc(options.limit ?? DEFAULT_LIMIT), 1), MAX_LIMIT)));
+  if (options.fuzzy) params.set("fuzzy", "true");
+  for (const knr of options.municipalityNumbers ?? []) params.append("knr", knr);
+  for (const fnr of options.countyNumbers ?? []) params.append("fnr", fnr);
+  const response = await fetch(url, { signal: options.signal });
+  if (!response.ok) {
+    throw new Error(`Geonorge place search failed: ${response.status} ${response.statusText}`);
+  }
+  const body = await response.json();
+  return (body.navn ?? []).map(toPlaceHit);
+}
+function toPlaceHit(navn) {
+  const type = navn.navneobjekttype.trim();
+  return {
+    id: `${navn.stedsnummer}-${navn.spr\u00E5k}-${navn.skrivem\u00E5te}`,
+    placeId: String(navn.stedsnummer),
+    name: navn.skrivem\u00E5te,
+    language: navn.spr\u00E5k,
+    type,
+    municipalities: navn.kommuner?.map((k) => k.kommunenavn.trim()) ?? [],
+    counties: navn.fylker?.map((f) => f.fylkesnavn.trim()) ?? [],
+    coordinates: { lat: navn.representasjonspunkt.nord, lon: navn.representasjonspunkt.\u00F8st },
+    targetMetersPerPixel: metersPerPixelForType(type)
+  };
+}
+
 // src/core/state/store.ts
 function createEmitter() {
   const listeners = {};
@@ -2418,6 +2783,16 @@ var SelectController = class {
   }
 };
 
+// src/core/ol/zoom/ground-resolution.ts
+var import_proj6 = require("ol/proj");
+var import_math = require("ol/math");
+function zoomForGroundResolution(view, lonLat, metersPerPixel) {
+  const projection = view.getProjection();
+  const groundMetersPerUnit = (0, import_proj6.getPointResolution)(projection, 1, (0, import_proj6.fromLonLat)(lonLat, projection), "m");
+  const zoom = view.getZoomForResolution(metersPerPixel / groundMetersPerUnit) ?? view.getMinZoom();
+  return (0, import_math.clamp)(zoom, view.getMinZoom(), view.getMaxZoom());
+}
+
 // src/core/ol/OlMapEngine.ts
 function resolveVectorSource(layer) {
   const src = layer.getSource();
@@ -2843,6 +3218,9 @@ function createOlEngine(events) {
     },
     getCenterFromExtent: (extent) => {
       return (0, import_extent6.getCenter)(extent);
+    },
+    getZoomForGroundResolution: (lonLat, metersPerPixel) => {
+      return zoomForGroundResolution(map.getView(), lonLat, metersPerPixel);
     }
   };
 }
@@ -3090,6 +3468,21 @@ var MapAPI = class {
   getCenterFromExtent(extent) {
     return this.engine.getCenterFromExtent(extent);
   }
+  // Place search
+  /**
+   * Prefix search for place names in Geonorge (https://ws.geonorge.no/stedsnavn/v1/#/default/get_navn).
+   * `zoomLevel` is computed for this map's view. Abort `options.signal` to cancel.
+   */
+  async searchPlaces(query, options) {
+    const places = await searchGeonorgePlaces(query, options);
+    return places.map(({ targetMetersPerPixel, ...place }) => ({
+      ...place,
+      zoomLevel: this.engine.getZoomForGroundResolution(
+        [place.coordinates.lon, place.coordinates.lat],
+        targetMetersPerPixel
+      )
+    }));
+  }
 };
 
 // src/api/config.schema.ts

package/dist/index.d.cts

@@ -314,6 +314,43 @@ interface InsertGeomOptions {
     /** CRS of the incoming coordinates. If omitted, assume map/view projection. */
     dataProjection?: string;
 }
+interface PlaceSearchOptions {
+    /** Abort to cancel, e.g. while the user is still typing. The promise then rejects with an AbortError. */
+    signal?: AbortSignal;
+    /** Max number of results, 1–500. Default: 10 */
+    limit?: number;
+    /** Also match similar spellings, e.g. "Galdhopiggen" finds Galdhøpiggen. */
+    fuzzy?: boolean;
+    /** Only search in these municipalities (kommunenummer), e.g. ['5501']. */
+    municipalityNumbers?: string[];
+    /** Only search in these counties (fylkesnummer), e.g. ['55']. */
+    countyNumbers?: string[];
+}
+/**
+ * One spelling of a place name from Geonorge. A place with several spellings
+ * (e.g. Tromsø / Romsa / Tromssa) gives one result per spelling, sharing `placeId`.
+ */
+interface PlaceSearchResult {
+    /** Unique per result. */
+    id: string;
+    /** Geonorge stedsnummer, shared by all spellings of a place. */
+    placeId: string;
+    name: string;
+    /** e.g. 'Norsk', 'Nordsamisk', 'Kvensk' */
+    language: string;
+    /** Geonorge navneobjekttype, e.g. 'Fjord', 'By' */
+    type: string;
+    /** As Geonorge delivers them, including Sami/Kven variants. Empty for e.g. sea areas. */
+    municipalities: string[];
+    counties: string[];
+    /** WGS84 */
+    coordinates: {
+        lat: number;
+        lon: number;
+    };
+    /** Zoom for this map's view that suits the place type. */
+    zoomLevel: number;
+}
 
 type MapEventMap = {
     ready: void;
@@ -542,6 +579,7 @@ interface MapEngine {
     } | null;
     getTargetElement(): HTMLElement | null;
     getCenterFromExtent(extent: Extent): MapCoord;
+    getZoomForGroundResolution(lonLat: [number, number], metersPerPixel: number): number;
 }
 
 declare class MapAPI {
@@ -641,6 +679,11 @@ declare class MapAPI {
     } | null;
     getTargetElement(): HTMLElement | null;
     getCenterFromExtent(extent: Extent): MapCoord;
+    /**
+     * Prefix search for place names in Geonorge (https://ws.geonorge.no/stedsnavn/v1/#/default/get_navn).
+     * `zoomLevel` is computed for this map's view. Abort `options.signal` to cancel.
+     */
+    searchPlaces(query: string, options?: PlaceSearchOptions): Promise<PlaceSearchResult[]>;
 }
 
 declare function createMap(target: string | HTMLElement, rawConfig: unknown): MapAPI;
@@ -802,4 +845,4 @@ interface NibTokenManager {
  */
 declare function createNibToken(config?: NibTokenConfig): NibTokenManager;
 
-export { type LayerDef, type MapEventName, type MapEventPayload, MapEvents, type MapInit, MapAPI as NbicMapComponent, type NibToken, type NibTokenConfig, type NibTokenManager, createMap, createNibToken, index$2 as nbicMapGeojson, index as nbicMapPresets, index$1 as nbicMapUtils };
+export { type LayerDef, type MapEventName, type MapEventPayload, MapEvents, type MapInit, MapAPI as NbicMapComponent, type NibToken, type NibTokenConfig, type NibTokenManager, type PlaceSearchOptions, type PlaceSearchResult, createMap, createNibToken, index$2 as nbicMapGeojson, index as nbicMapPresets, index$1 as nbicMapUtils };

package/dist/index.d.ts

@@ -314,6 +314,43 @@ interface InsertGeomOptions {
     /** CRS of the incoming coordinates. If omitted, assume map/view projection. */
     dataProjection?: string;
 }
+interface PlaceSearchOptions {
+    /** Abort to cancel, e.g. while the user is still typing. The promise then rejects with an AbortError. */
+    signal?: AbortSignal;
+    /** Max number of results, 1–500. Default: 10 */
+    limit?: number;
+    /** Also match similar spellings, e.g. "Galdhopiggen" finds Galdhøpiggen. */
+    fuzzy?: boolean;
+    /** Only search in these municipalities (kommunenummer), e.g. ['5501']. */
+    municipalityNumbers?: string[];
+    /** Only search in these counties (fylkesnummer), e.g. ['55']. */
+    countyNumbers?: string[];
+}
+/**
+ * One spelling of a place name from Geonorge. A place with several spellings
+ * (e.g. Tromsø / Romsa / Tromssa) gives one result per spelling, sharing `placeId`.
+ */
+interface PlaceSearchResult {
+    /** Unique per result. */
+    id: string;
+    /** Geonorge stedsnummer, shared by all spellings of a place. */
+    placeId: string;
+    name: string;
+    /** e.g. 'Norsk', 'Nordsamisk', 'Kvensk' */
+    language: string;
+    /** Geonorge navneobjekttype, e.g. 'Fjord', 'By' */
+    type: string;
+    /** As Geonorge delivers them, including Sami/Kven variants. Empty for e.g. sea areas. */
+    municipalities: string[];
+    counties: string[];
+    /** WGS84 */
+    coordinates: {
+        lat: number;
+        lon: number;
+    };
+    /** Zoom for this map's view that suits the place type. */
+    zoomLevel: number;
+}
 
 type MapEventMap = {
     ready: void;
@@ -542,6 +579,7 @@ interface MapEngine {
     } | null;
     getTargetElement(): HTMLElement | null;
     getCenterFromExtent(extent: Extent): MapCoord;
+    getZoomForGroundResolution(lonLat: [number, number], metersPerPixel: number): number;
 }
 
 declare class MapAPI {
@@ -641,6 +679,11 @@ declare class MapAPI {
     } | null;
     getTargetElement(): HTMLElement | null;
     getCenterFromExtent(extent: Extent): MapCoord;
+    /**
+     * Prefix search for place names in Geonorge (https://ws.geonorge.no/stedsnavn/v1/#/default/get_navn).
+     * `zoomLevel` is computed for this map's view. Abort `options.signal` to cancel.
+     */
+    searchPlaces(query: string, options?: PlaceSearchOptions): Promise<PlaceSearchResult[]>;
 }
 
 declare function createMap(target: string | HTMLElement, rawConfig: unknown): MapAPI;
@@ -802,4 +845,4 @@ interface NibTokenManager {
  */
 declare function createNibToken(config?: NibTokenConfig): NibTokenManager;
 
-export { type LayerDef, type MapEventName, type MapEventPayload, MapEvents, type MapInit, MapAPI as NbicMapComponent, type NibToken, type NibTokenConfig, type NibTokenManager, createMap, createNibToken, index$2 as nbicMapGeojson, index as nbicMapPresets, index$1 as nbicMapUtils };
+export { type LayerDef, type MapEventName, type MapEventPayload, MapEvents, type MapInit, MapAPI as NbicMapComponent, type NibToken, type NibTokenConfig, type NibTokenManager, type PlaceSearchOptions, type PlaceSearchResult, createMap, createNibToken, index$2 as nbicMapGeojson, index as nbicMapPresets, index$1 as nbicMapUtils };

package/dist/index.js

@@ -61,6 +61,371 @@ var mapBounds = [
   }
 ];
 
+// src/core/place-search/place-zoom.ts
+var METERS_PER_PIXEL_AT_ZOOM_0 = 156543.03392804097;
+var PLACE_ZOOM = {
+  point: 17,
+  // ~1.2 km across: buildings, single structures
+  small: 15,
+  // ~5 km: small natural features, farms' surroundings, neighbourhoods
+  medium: 13,
+  // ~19 km: lakes, mountains, valleys, towns
+  large: 11.5,
+  // ~54 km: fjords, mountain areas, municipalities
+  region: 9,
+  // ~300 km: counties, sea areas
+  country: 6
+  // ~2 400 km
+};
+var DEFAULT_ZOOM_CLASS = "small";
+var TYPES_BY_CLASS = {
+  point: [
+    "Adressetilleggsnavn",
+    "Annen bygning for religionsut\xF8velse",
+    "Annen industri- og lagerbygning",
+    "Annen kulturdetalj",
+    "Badeplass",
+    "Barnehage",
+    "Boinstitusjon",
+    "Boligblokk",
+    "Bomstasjon",
+    "Borettslag",
+    "Bru",
+    "Bruk",
+    "Brygge",
+    "Busstasjon",
+    "Busstopp",
+    "Bygg for jordbruk, fiske og fangst",
+    "B\xE5ke",
+    "Campingplass",
+    "Dam",
+    "Eiendom",
+    "Eiendomsteig",
+    "Enebolig/mindre boligbygg",
+    "Fabrikk",
+    "Fengsel",
+    "Ferjekai",
+    "Fjell i dagen",
+    "Fjellheis",
+    "Fl\xF8tningsanlegg",
+    "Forn\xF8yelsespark",
+    "Forretningsbygg",
+    "Forsamlingshus/kulturhus",
+    "Forskningsstasjon",
+    "Foss",
+    "Fritidsbolig",
+    "Fyllplass",
+    "Fyrlykt",
+    "Fyrstasjon",
+    "Gammel bosettingsplass",
+    "Garasje/hangarbygg",
+    "Gard",
+    "Gjerde",
+    "Gravplass",
+    "Grensemerke",
+    "Grind",
+    "Grotte",
+    "Grustak/steinbrudd",
+    "Gr\xF8ft",
+    "Helikopterlandingsplass",
+    "Heller",
+    "Helseinstitusjon",
+    "Historisk bosetting",
+    "Holdeplass",
+    "Hotell",
+    "H\xF8l",
+    "Idrettsanlegg",
+    "Idrettshall",
+    "Jernbanebru",
+    "Jernstang",
+    "Jorde",
+    "Kai",
+    "Kilde",
+    "Kirke",
+    "Klopp",
+    "Kraftstasjon",
+    "Kultur-/messehall",
+    "Landingsplass",
+    "Lanterne",
+    "Lysb\xF8ye",
+    "Matrikkeladressenavn",
+    "Melkeplass",
+    "Milit\xE6rt bygg/anlegg",
+    "Mindre brukonstruksjon",
+    "Molo",
+    "Museum/galleri/bibliotek",
+    "Navnegard",
+    "Offersted",
+    "Oppdrettsanlegg",
+    "Overbygg",
+    "Overett",
+    "Park",
+    "Parkeringsplass",
+    "Pensjonat",
+    "Pytt",
+    "Rasteplass",
+    "R\xE5dhus",
+    "Serveringssted",
+    "Seter/st\xF8l",
+    "Setervoll",
+    "Severdighet",
+    "Sj\xF8merke med indirekte belysning",
+    "Sj\xF8varde",
+    "Skiheis",
+    "Skogholt",
+    "Skole",
+    "Skytebane",
+    "Sluse",
+    "Sm\xE5b\xE5thavn",
+    "Stake",
+    "Stasjon",
+    "Stein",
+    "Stryk",
+    "St\xF8",
+    "St\xF8ls-/setereiendom",
+    "Sva",
+    "Sykehus",
+    "Torg",
+    "Torvtak",
+    "Tuft",
+    "Turisthytte",
+    "TV-/radio- eller mobiltelefont\xE5rn",
+    "T\xF8mmervelte",
+    "Universitet/h\xF8gskole",
+    "Utsiktspunkt",
+    "Utstikker",
+    "Vad",
+    "Vaktstasjon/beredsskapsbygning",
+    "Vannstandsm\xE5ler",
+    "Vannverk",
+    "Varde",
+    "Vegbom",
+    "Vegkryss",
+    "Vegsving",
+    "\xD8yr"
+  ],
+  small: [
+    "Administrativ bydel",
+    "Adressenavn",
+    "Alpinanlegg",
+    "Ankringsplass",
+    "Annen terrengdetalj",
+    "Annen vanndetalj",
+    "Bakke",
+    "Bakke (Veg)",
+    "Bakke i sj\xF8",
+    "Bakketopp i sj\xF8",
+    "Bekk",
+    "Berg",
+    "Bergverk",
+    "Boligfelt",
+    "Botn",
+    "Bydel",
+    "B\xE5e",
+    "B\xE5e i sj\xF8",
+    "Del av innsj\xF8",
+    "Del av vann",
+    "Egg",
+    "Eid",
+    "Eid i sj\xF8",
+    "Elvemel",
+    "Elvesving",
+    "Eng",
+    "Fiskeplass i sj\xF8",
+    "Fjellkant",
+    "Fjellside",
+    "Fjelltopp i sj\xF8",
+    "Fjellvegg",
+    "Flyplass",
+    "Fonn",
+    "Friluftsomr\xE5de",
+    "Grend",
+    "Grunne",
+    "Grunne i sj\xF8",
+    "Grunnkrets",
+    "Gruppe av tjern",
+    "Hammar",
+    "Haug",
+    "Havn",
+    "Havnehage",
+    "Holme",
+    "Holme i sj\xF8",
+    "Holmegruppe i sj\xF8",
+    "Hylle",
+    "Hyttefelt",
+    "H\xF8yde",
+    "Industriomr\xE5de",
+    "Jernbanetunnel",
+    "Juv",
+    "Kabel",
+    "Kanal",
+    "Klakk i sj\xF8",
+    "Korallrev",
+    "Kraftgate (r\xF8rgate)",
+    "Krater",
+    "Li",
+    "Lon",
+    "Mo",
+    "Myr",
+    "Nes",
+    "Nes i sj\xF8",
+    "Nes ved elver",
+    "Oljeinstallasjon",
+    "Os",
+    "Rev i sj\xF8",
+    "Rygg",
+    "Sand",
+    "Senkning",
+    "Sj\xF8detalj",
+    "Skar",
+    "Skj\xE6r",
+    "Skj\xE6r i sj\xF8",
+    "Skog",
+    "Skredomr\xE5de",
+    "Slette",
+    "Sti",
+    "Strand",
+    "Strand i sj\xF8",
+    "Stup",
+    "Sund",
+    "Sund i sj\xF8",
+    "S\xF8kk",
+    "Taubane",
+    "Tettbebyggelse",
+    "Tettsteddel",
+    "Tjern",
+    "Topp",
+    "Traktorveg",
+    "Tunnel",
+    "Ur",
+    "Utmark",
+    "Vann",
+    "Vik",
+    "Vik i sj\xF8",
+    "V\xE5g i sj\xF8",
+    "V\xE5tmarksomr\xE5de",
+    "\xD8y",
+    "\xC5s"
+  ],
+  medium: [
+    "Allmenning",
+    "Annen administrativ inndeling",
+    "Banestrekning",
+    "Banke",
+    "By",
+    "Bygdelag (bygd)",
+    "Dal",
+    "Egg i sj\xF8",
+    "Elv",
+    "Farled/skipslei",
+    "Ferjestrekning",
+    "Fjell",
+    "Fjellovergang",
+    "Fjordmunning",
+    "Gass-/oljefelt i sj\xF8",
+    "Gruppe av vann",
+    "Halv\xF8y",
+    "Halv\xF8y i sj\xF8",
+    "Hei",
+    "Hylle i sj\xF8",
+    "Innsj\xF8",
+    "Isbre",
+    "Kraftledning",
+    "Landskapsomr\xE5de",
+    "Morenerygg i sj\xF8",
+    "Poststed",
+    "Ras i sj\xF8",
+    "Renne/Kl\xF8ft i sj\xF8",
+    "Rygg i sj\xF8",
+    "R\xF8rledning",
+    "Sadel i sj\xF8",
+    "Sj\xF8stykke",
+    "Skogomr\xE5de",
+    "Skolekrets",
+    "Skytefelt",
+    "Sokn",
+    "Statistisk tettsted",
+    "S\xF8kk i sj\xF8",
+    "Tettsted",
+    "Undersj\xF8isk vegg",
+    "Valgkrets",
+    "Vegstrekning",
+    "Verneomr\xE5de",
+    "Vulkan i sj\xF8",
+    "\xD8y i sj\xF8",
+    "\xD8ygruppe"
+  ],
+  large: [
+    "Banke i sj\xF8",
+    "Basseng i sj\xF8",
+    "Dalf\xF8re",
+    "Fjellkjede i sj\xF8",
+    "Fjellomr\xE5de",
+    "Fjord",
+    "Geologisk struktur",
+    "Havdyp",
+    "Iskuppel",
+    "Kommune",
+    "Plat\xE5 i sj\xF8",
+    "Reinbeitedistrikt",
+    "Sokkel i sj\xF8",
+    "Vidde",
+    "\xD8ygruppe i sj\xF8"
+  ],
+  region: ["Fylke", "Havomr\xE5de", "Havstr\xF8m", "Kontinentalsokkel", "Soneinndeling til havs"],
+  country: ["Nasjon"]
+};
+var CLASS_BY_TYPE = new Map(
+  Object.entries(TYPES_BY_CLASS).flatMap(
+    ([cls, types]) => types.map((t) => [t, cls])
+  )
+);
+function zoomClassForType(type) {
+  return CLASS_BY_TYPE.get(type.trim()) ?? DEFAULT_ZOOM_CLASS;
+}
+function metersPerPixelForType(type) {
+  return METERS_PER_PIXEL_AT_ZOOM_0 / 2 ** PLACE_ZOOM[zoomClassForType(type)];
+}
+
+// src/core/place-search/geonorge.ts
+var GEONORGE_NAVN_URL = "https://ws.geonorge.no/stedsnavn/v1/navn";
+var DEFAULT_LIMIT = 10;
+var MAX_LIMIT = 500;
+var REJECTED_CHARACTERS = /["?;%\\]/g;
+async function searchGeonorgePlaces(query, options = {}) {
+  options.signal?.throwIfAborted();
+  const term = query.replace(REJECTED_CHARACTERS, "").trim();
+  if (!term.replace(/\*/g, "")) return [];
+  const url = new URL(GEONORGE_NAVN_URL);
+  const params = url.searchParams;
+  params.set("sok", term.endsWith("*") ? term : `${term}*`);
+  params.set("utkoordsys", "4326");
+  params.set("treffPerSide", String(Math.min(Math.max(Math.trunc(options.limit ?? DEFAULT_LIMIT), 1), MAX_LIMIT)));
+  if (options.fuzzy) params.set("fuzzy", "true");
+  for (const knr of options.municipalityNumbers ?? []) params.append("knr", knr);
+  for (const fnr of options.countyNumbers ?? []) params.append("fnr", fnr);
+  const response = await fetch(url, { signal: options.signal });
+  if (!response.ok) {
+    throw new Error(`Geonorge place search failed: ${response.status} ${response.statusText}`);
+  }
+  const body = await response.json();
+  return (body.navn ?? []).map(toPlaceHit);
+}
+function toPlaceHit(navn) {
+  const type = navn.navneobjekttype.trim();
+  return {
+    id: `${navn.stedsnummer}-${navn.spr\u00E5k}-${navn.skrivem\u00E5te}`,
+    placeId: String(navn.stedsnummer),
+    name: navn.skrivem\u00E5te,
+    language: navn.spr\u00E5k,
+    type,
+    municipalities: navn.kommuner?.map((k) => k.kommunenavn.trim()) ?? [],
+    counties: navn.fylker?.map((f) => f.fylkesnavn.trim()) ?? [],
+    coordinates: { lat: navn.representasjonspunkt.nord, lon: navn.representasjonspunkt.\u00F8st },
+    targetMetersPerPixel: metersPerPixelForType(type)
+  };
+}
+
 // src/core/state/store.ts
 function createEmitter() {
   const listeners = {};
@@ -2334,6 +2699,16 @@ var SelectController = class {
   }
 };
 
+// src/core/ol/zoom/ground-resolution.ts
+import { fromLonLat, getPointResolution } from "ol/proj";
+import { clamp } from "ol/math";
+function zoomForGroundResolution(view, lonLat, metersPerPixel) {
+  const projection = view.getProjection();
+  const groundMetersPerUnit = getPointResolution(projection, 1, fromLonLat(lonLat, projection), "m");
+  const zoom = view.getZoomForResolution(metersPerPixel / groundMetersPerUnit) ?? view.getMinZoom();
+  return clamp(zoom, view.getMinZoom(), view.getMaxZoom());
+}
+
 // src/core/ol/OlMapEngine.ts
 function resolveVectorSource(layer) {
   const src = layer.getSource();
@@ -2759,6 +3134,9 @@ function createOlEngine(events) {
     },
     getCenterFromExtent: (extent) => {
       return getCenter3(extent);
+    },
+    getZoomForGroundResolution: (lonLat, metersPerPixel) => {
+      return zoomForGroundResolution(map.getView(), lonLat, metersPerPixel);
     }
   };
 }
@@ -3006,6 +3384,21 @@ var MapAPI = class {
   getCenterFromExtent(extent) {
     return this.engine.getCenterFromExtent(extent);
   }
+  // Place search
+  /**
+   * Prefix search for place names in Geonorge (https://ws.geonorge.no/stedsnavn/v1/#/default/get_navn).
+   * `zoomLevel` is computed for this map's view. Abort `options.signal` to cancel.
+   */
+  async searchPlaces(query, options) {
+    const places = await searchGeonorgePlaces(query, options);
+    return places.map(({ targetMetersPerPixel, ...place }) => ({
+      ...place,
+      zoomLevel: this.engine.getZoomForGroundResolution(
+        [place.coordinates.lon, place.coordinates.lat],
+        targetMetersPerPixel
+      )
+    }));
+  }
 };
 
 // src/api/config.schema.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artsdatabanken/nbic-map-component",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Shared map component built on OpenLayers",
   "type": "module",
   "main": "./dist/index.cjs",