AdresseVaelger

Beskrivelse

Dansk navn: AdresseVaelger
Engelsk navn: AdresseVaelger
Ikon: Ingen (ingen UI-knap)

Lader søgefeltet bruge Klimadatastyrelsens Adressevælger. Child under Search.

Hvor det indgår

Desktop	Mobil	Forside	Indlejret	Dashboard	GeoStory	Kontekst
Ja	Ja	Nej	Ja	Nej	Nej	Kan vælges. Slås til med Search

Fra eksempel-konfigurationen for 2026.11. Se alle plugins i Plugin-placering.

Opsætning

AdresseVaelger sættes op to steder: pluginet med token og API-nøgle, og søgetjenesten i Search-pluginet. Begge dele skal være med, i localConfig.json eller i en kontekst.

I localConfig.json

1. Tilføj pluginet i plugins.desktop (og plugins.mobile, hvis søgningen også skal bruges på mobil):

{
  "name": "AdresseVaelger",
  "cfg": {
    "token": "adressevaelger123",
    "datafordelerAPIKey": "***"
  }
}

2. Tilføj søgetjenesten i Search-pluginets cfg.searchOptions.services i samme liste:

{
  "type": "AdresseVaelger",
  "priority": 1,
  "name": "Adresse",
  "displayName": "${properties.titel}",
  "subTitle": "${properties.subtitle}",
  "searchTextTemplate": "${properties.titel}",
  "options": {
    "url": "https://adressevaelger.dk/husnumre/soeg/",
    "maxZoomLevel": 13,
    "params": {
      "maksimum": 30,
      "kommunekode": null
    }
  },
  "geomService": {
    "type": "AdresseVaelgerGeom",
    "priority": 1,
    "name": "Adresse",
    "displayName": "${properties.titel}",
    "subTitle": "Adresse",
    "options": {
      "staticFilter": "${properties.data}",
      "url": "https://adressevaelger.dk/husnumre",
      "kommunekode": null
    }
  }
}

I en kontekst

Ny kontekst: Aktivér Search i konteksteditorens trin med plugins. AdresseVaelger aktiveres sammen med Search, og begge har standardopsætningen fra Standardkonfiguration i pluginsConfig.json: token, API-nøgle og AdresseVaelger-søgetjenesten.

Eksisterende kontekst:

1. Åbn konteksten i konteksteditoren, og gå til trinnet med plugins.

2. Aktivér AdresseVaelger under Search.

3. Konfigurér AdresseVaelger, og kontrollér token og datafordelerAPIKey:

   {
     "token": "adressevaelger123",
     "datafordelerAPIKey": "***"
   }

4. Konfigurér Search, og erstat gsearch-tjenesterne til adresser og veje i searchOptions.services med AdresseVaelger-søgetjenesten fra trin 2 ovenfor.

5. Gsearch kan fjernes fra konteksten, når ingen søgetjenester bruger den.

6. Gem konteksten.

Søgetjenesten kan begrænses til bestemte kommuner, se Begræns til bestemte kommuner.

Tilpasning

Token og API-nøgle

I pluginets cfg (trin 1):

• token — token til Adressevælger. Klimadatastyrelsen anbefaler, at alle bruger det fælles token adressevaelger123, indtil der kommer brugerstyring på Adressevælger (forventet ultimo 2026 eller primo 2027). Se Brugerstyring (åbner i et nyt vindue)
• datafordelerAPIKey — API-nøgle til Datafordeleren. Bruges til at vise veje på kortet

Antal resultater

• maksimum i søgetjenestens params — antal resultater fra Adressevælger (standard 100, maks. 200)
• maxResults i Search-pluginets cfg — antal resultater i søgelisten i alt, for alle søgetjenester (standard 15). Sæt den højere end maksimum, så der er plads til de andre søgetjenesters resultater

{
  "name": "Search",
  "cfg": {
    "maxResults": 40,
    "searchOptions": { "services": [ ... ] }
  }
}

Zoomniveau

maxZoomLevel i søgetjenestens options — hvor tæt kortet zoomer ind på en valgt adresse (standard 21). 13 passer til kort i EPSG:25832.

Begræns til bestemte kommuner

Erstat null i kommunekode med kommunekoden de to steder i søgetjenesten (trin 2):

"options": {
  "url": "https://adressevaelger.dk/husnumre/soeg/",
  "maxZoomLevel": 13,
  "params": {
    "maksimum": 30,
    "kommunekode": "0461"
  }
},
"geomService": {
  ...
  "options": {
    "staticFilter": "${properties.data}",
    "url": "https://adressevaelger.dk/husnumre",
    "kommunekode": "0461"
  }
}

• options.params.kommunekode — begrænser søgeresultaterne
• geomService.options.kommunekode — begrænser, hvilke veje der vises på kortet, når der vælges et vejnavn. Sæt den til det samme som params.kommunekode
• Flere kommuner: adskilt med komma, "0410,0461", eller som liste, ["0410", "0461"]
• Kommunekoder skrives med fire cifre, "0461". Kortere koder, som "461" eller 461, får automatisk nuller foran
• null, "" eller [] — ingen begrænsning: hele landet

Rutevejledning og isokroner

Rutevejledning og Isokroner søger adresser med søgetjenesten AdresseVaelgerPunkt i deres searchConfig. AdresseVaelger-pluginet skal være aktiveret, i localConfig.json eller i konteksten. Svarer Adressevælger ikke, søges der i Nominatim (OpenStreetMap, kun Danmark) i stedet.

"searchConfig": {
  "displayName": "properties.titel",
  "maxResults": 5,
  "services": [
    {
      "type": "AdresseVaelgerPunkt",
      "options": {
        "url": "https://adressevaelger.dk/husnumre/soeg/",
        "params": {
          "maksimum": 5,
          "kommunekode": null
        }
      }
    }
  ]
}

• params.kommunekode — begrænser søgeresultaterne til bestemte kommuner, som i søgefeltet
• Resultatlisten viser veje og adresser. En vej placeres ved sin første adresse

Standardkonfiguration i localConfig.json

I plugins.desktop, plugins.mobile og plugins.embedded, sammen med AdresseVaelger-søgetjenesten i Search (se I localConfig.json). Search har "maxResults": 40.

{
  "name": "AdresseVaelger",
  "cfg": {
    "token": "adressevaelger123",
    "datafordelerAPIKey": "***"
  }
}

Standardkonfiguration i pluginsConfig.json

{
  "name": "AdresseVaelger",
  "glyph": "search",
  "hidden": false,
  "title": "plugins.AdresseVaelger.title",
  "description": "plugins.AdresseVaelger.description",
  "defaultConfig": {
    "token": "adressevaelger123",
    "datafordelerAPIKey": "***"
  }
}

AdresseVaelger er med i Search-pluginets children og autoEnableChildren. Search-pluginets defaultConfig har "maxResults": 40 og AdresseVaelger-søgetjenesten fra trin 2.