Søg i Septima Widget K

Søg ​

Søgning på flere ting, herunder adresser, stednavne, lokale data m.m. Funktionen bruger Septima Search, og alt hvad der kan søges i via Septima Search, kan der søges i her.

Options ​

Herunder findes en beskrivelse af de enkelte egenskaber, der kan sættes på funktionen.

disable ​

  • Type: boolean
  • Default: false

Skal kontrollen deaktiveres. Herved fungerer det, som om kontrollen ikke var tilføjet. Kan bruges til midlertidig at fjerne en kontrol.

detach ​

  • Type: string

Angiv en reference til et alternativ html-element, som denne kontrol skal vises i. Det kan benyttes til at placere indholdet af en kontrol et andet sted på sin side. Hvis detach har værdien "abc", så skal der tlføjes et element til HTML'en på denne form: <div data-widget-detach="abc"/>. Hvis elementet ikke findes, så fungerer kontrollen, som hvis detach ikke var angivet.

css ​

  • Type: string | string[]

Angiv en sti til en css-fil, der skal loades efter denne kontrol. Herved vil det være muligt at lave en brugertilpasset style af kontrollen.

className ​

  • Type: string

Tilføj en speciel CSS class til elementet. Dette kan bruges til at styre hvordan elementet ser ud eller placeres på siden.

displaytext ​

  • Type: string

Angiver "placeholder/ledetekst"-teksten i søgefeltet.

noResults ​

  • Type: string
  • Default: Ingen resultater

Angiver den tekst, der skal vises når der ikke er fundet noget.

showSearchText ​

  • Type: boolean
  • Default: false

Skal det valgte vises i inputfeltet? Dette gør det nemmere at forstår hvad der er valgt, men samtidigt er det sværere at søge videre efter der er valgt noget.

selectInfo ​

  • Type: boolean
  • Default: false

Skal den valgte adresse vises under søgeboksen med ikon. Herved er det muligt at se, hvad det er, der er fundet i kortet.

features_style ​

  • Type: object

Hvordan skal objekterne styles i kortet, når de er fundet. Læs mere om features_style her.

minResolution ​

  • Type: number
  • Default: 3.2

Hvor langt skal der maksimalt zoomes ind til. Dette tal angives som antallet af meter, hver pixel er i dette zoomniveau.

preventZoom ​

  • Type: boolean
  • Default: false

Skal zoom deaktiveres.

blankBehavior ​

  • Type: string
  • Default: none

Skal der søges allerede, når brugeren stiller sig i søgefeltet? Default er none, hvorved der ikke søges, før brugeren skriver noget i søgefeltet. Hvis man angiver search, så søges der med det samme.

charLimit ​

  • Type: number
  • Default: 1

Angiv antallet at tegn, der skal indtastes i søgefeltet før der søges. Dette kan f.eks. bruges til at forhindre at søgningen går i gang så snart der er angivet et enkelt tegn.

silent ​

  • Type: boolean
  • Default: false

Skal valget bruges til at aktivere andre funktioner som f.eks. Konfliktsøgning eller Find nærmeste.

driver ​

  • Type: object[]

Angiver en liste af drivere, der skal søges i. Læs mere her.

autofocus ​

  • Type: boolean
  • Default: false

Skal søgefeltet være aktivt når siden loades. Dette kan være en fordel, men også en ulempe for brugeren. Derfor skal det nøje overvejes om denne parametre skal sættes.

clearOnMapclick ​

  • Type: boolean
  • Default: false

Skal markeringen fra en søgning fjernes når der klikker i kortet.

paramNames ​

  • Type: object

Det er muligt at angive en række parametre, der styre hvordan søgefeltet opfører sig. Pt. er det muligt at angive hvilken hjælpetekst displaytext, der skal vises samt om søgefeltet skal være i fokus autofocus når siden loades:

json
"paramNames": {
  "autofocus": "autofocus",
  "displaytext": "displaytext"
}

Hvad, der skal søges i ​

Opsætningen til hver enkelt søgning.

Bemærk

Hvis du vil søge i lokale data, men bruge templates og styles fra data i stedet for at angive dem under søgefunktionen, er det muligt. Tilføj blot template_search_title og template_search_description til laget samt fjern "displaynameProperty" fra konfigurationen til funktionen.

type ​

  • Type: string

Søg i adresser (address), CVR (cvr), Plandata.dk (plan), Septima Search Service (s3), S4 index (s4), GSearch fra Dataforsyningen (gsearch) eller i objekter i kortet (local)

minResolution ​

  • Type: number
  • Default: 3.2

Hvor langt skal der maksimalt zoomes ind til. Dette tal angives som antallet af meter, hver pixel er i dette zoomniveau.

options ​

  • Type: object

Afhængig af hvad der søges i, skal der angives en række parametre:

  • Til alle typer er det muligt at angive parameteren "minimumShowCount": 3 med et antal hits, der altid skal vises selvom der er flere. For adressesøgningen er denne værdi default 3, mens den for alle andre er 0.

  • Til "type":"dawa" eller "type":"address" kan angives med parameteren "highlightRoad": true, der bestemmer om man vil have markeret vejen i kortet når vejen vælges i listen. Derudover er det muligt at angive "kommunekode" for at begrænse søgningen til bestemte kommuner. Det kan f.eks. gøres med: "kommunekode": "101" Kommunekoden kan være en liste med kommunekoder, f.eks.: "kommunekode": "101,161,163". Hvis det ønskes at søge på adgangsadresser, tilføjes "goal": "adgangellerenhedsadresse".

  • Til "type":"geosearch" er det muligt at angive "kommunekode" på samme måde som ved "type":"dawa". Derudover kan der angives "targets", der er et array af, hvad der skal søges i: "targets": ["postdistrikter","matrikelnumre"]. Det er ikke muligt at anvende "adresser" og "stednavne", da der er specelle drivere til det.

  • Til "type":"stednavn" kan der angives parameteren "kommunekode" på samme måde som ved "type":"dawa". Med denne type søges der i de officielle danske stednavne.

  • Til "type":"local" angives parametrene "singular", "plural", "displaynameProperty" samt "descriptionProperty".

  • Til "type":"s3" angives parametrene "host", samt "service".

  • Til "type":"s4" angives parametrene "host", samt "datasources".

  • Til "type":"cvr" er det muligt at angive "kommunekode" på samme måde som ved "type":"dawa".

  • Til "type":"plan" er det muligt at angive "kommunekode" på samme måde som ved "type":"dawa".

  • Til "type":"arcgis" angives parametrene "catalogUrl", "serviceName" samt "layers".

crs ​

  • Type: string
  • Default: EPSG:25832

Servicens koordinatreferencesystem defineret i EPSG, eksempelvis: EPSG:25832.

geometryProxy ​

  • Type: object

Brug det fundet objekt (adresse) til at finde den geometri, der rent faktisk skal benyttes til f.eks. at markere i kortet. Både geometrien fra det fundet objekt samt oplysnignerne fra objektet, kan bruges i forbindelse med "host".

"geometryProxy" skal være et objekt, der indeholder "host" samt "type" i stil med dette:

https://myservice.dk/gis/rest/services/Vej_Trafik/Lette_Trafikanter/MapServer/9/query?returnGeometry=true&outSR=25832&f=json&outFields=*&where=wkt=POINT(%20)"

json
"geometryProxy": {
    "host": "//myservice.dk/gis/rest/.../query?...&where=wkt=POINT({{x}}%20{{y}})",
    "type": "esrijson"
}

Det er muligt at angive "condition": "..." på "geometryProxy". Herved er det muligt at styre hvornår denne proxy skal kaldes. Indholdet i "condition" er en template, der tager inputtet fra den valgte vej, husnummer eller hvad der nu er valgt.

silent ​

  • Type: boolean
  • Default: false

Skal valget af denne driver bruges til at aktivere andre funktioner som f.eks. Konfliktsøgning eller Find nærmeste.

layer ​

  • Type: string | object
  • Default: ""

Her angives id'et på det lag, der skal tændes når et objekt af denne type vælges i søgefeltet. Hvis flere lag skal tændes, angives en kommasepareret liste med id'er. Det er også muligt at angive en skabelon, der bruger det valgte objekts attributter til at danne lagnavnet med. Attributter fra data kan angives i skabelonen med følgende notation <%= attributes.kategori %>. Læs mere om templates generelt her.

iconURI ​

  • Type: string

Bestem selv hvilket ikon, der skal vises i søgefeltet. Vædrien skal være en URI. Det betyder at billedet skal skrevet som tekst i stil med "data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PS...".

  • Type: object

Vis en popup for det markerede objekt.

"popup" skal være et objekt, der kan indeholder "delay", "template" samt "geometryOptions" (som beskrevet under features_style) i stil med dette:

json
"popup": {
    "delay": 1500,
    "className": "widget-map-popup"
    "template": "<div><%= dist %> meter - <%= time %> sekunder</div>",
    "geometryOptions": {
        "type": "interiorPoint"
    }
}

Eksempler ​

Eksempler, der bruger denne komponent: