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 default3
, mens den for alle andre er0
.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..."
.
popup
- 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: