ggc-library
    Preparing search index...

    Service voor het selecteren en highlighten van features op de kaart.

    De GgcSelectionService biedt ondersteuning voor selectie‑interacties op verschillende typen kaartlagen en abstracteert de onderliggende OpenLayers‑selectielogica via de CoreSelectionService.

    De service ondersteunt selecties op alle kaartlagen, maar het gebruik van WFS‑ of OGC‑kaartlagen wordt sterk aanbevolen. Deze lagen bevatten features als vector‑data in de front‑end, wat uitgebreidere en stabielere selectiemogelijkheden biedt.

    Selecties op WMS/WMTS‑kaartlagen worden ook ondersteund, maar kennen functionele beperkingen (zie hieronder).

    Let op: kaartlagen moeten de optie getFeatureInfoOnSingleclick op true hebben staan om er selecties op te kunnen uitvoeren.

    Voor WFS‑ en OGC‑kaartlagen zijn de volgende selectiemodi beschikbaar:

    • Single select Door te klikken wordt één feature geselecteerd. Een nieuwe selectie vervangt de bestaande selectie.

    • Multi select Meerdere features kunnen geselecteerd worden. Door op een reeds geselecteerde feature te klikken, wordt deze uit de selectie verwijderd.

    • OpenLayers default Standaard OpenLayers‑gedrag:

      • normale klik → single select
      • shift‑klik → multi select

    Selecties op WMS‑ en WMTS‑kaartlagen werken anders dan bij vector‑lagen, omdat de features niet permanent in de front‑end beschikbaar zijn.

    Voor WMS/WMTS‑selecties gelden de volgende vereisten en beperkingen:

    • Selecties werken alleen via singleclick in:
      • single select modus
      • multi select modus
    • De GetFeatureInfo‑response moet een geometry bevatten, anders kan de feature niet worden gehighlight.

    Buiten deze beperkingen gedragen WMS‑ en WMTS‑kaartlagen zich verder hetzelfde binnen de GgcSelectionService en kunnen zij:

    • gecombineerd worden met andere kaartlagen;
    • gelijktijdig gebruikt worden met WFS/OGC‑lagen;
    • gefilterd worden via layerIds bij het starten van een selectie.

    De service throws selectie‑events via een Observable van MapComponentEvent. Deze events kunnen gebruikt worden om selectie‑wijzigingen te volgen en te synchroniseren met andere componenten.

    Index

    Methods

    • Cleart alle selecties voor de opgegeven kaartindex.

      Parameters

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele kaartindex (default: DEFAULT_MAPINDEX) waarvoor alle selecties worden gewist.

      Returns void

    • Verwijdert alle huidige selecties van de opgegeven kaart.

      Parameters

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele kaartindex (default: DEFAULT_MAPINDEX) waarvoor de selectie wordt gewist.

      • OptionalselectIndex: string

        Optionele selectIndex waarvoor de selectie wordt gewist.

      Returns void

    • Geeft de actieve selectie van de opgegeven kaart.

      Parameters

      • selectIndex: string = DEFAULT_MAPINDEX

        Optionele selectIndex/kaartindex (default: DEFAULT_MAPINDEX) waarvoor de huidige selectie wordt opgehaald.

      Returns Feature<Geometry, { [x: string]: any }>[]

      De huidige selectie voor de opgegeven kaart.

    • Geeft een observable die selectie‑gerelateerde events emit voor de opgegeven kaart. De mapIndex in het event refereert naar de selectIndex als die is opgegeven, anders de mapIndex.

      Parameters

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele kaartindex (default: DEFAULT_MAPINDEX) waarvoor selectie‑events worden gevolgd.

      • OptionalselectIndex: string

        Optionele selectIndex waarvoor selectie‑events worden gevolgd.

      Returns Observable<MapComponentEvent>

      Observable met MapComponentEvent selectie‑events.

    • Parameters

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele kaartindex (default: DEFAULT_MAPINDEX) waarvoor de selectiemodus wordt ingesteld.

      Returns void

      Zet de selectiemodus van de kaart op multi select. Hierbij kunnen meerdere objecten tegelijk geselecteerd worden. Alle kaartlagen die de optie getFeatureInfoOnSingleclick aan hebben staan kunnen geselecteerd worden.

    • Overschrijft de bestaande selectie met de meegegeven features.

      Parameters

      • features: Feature<Geometry, { [x: string]: any }>[]

        De nieuwe OpenLayers features die geselecteerd worden.

      • selectIndex: string = DEFAULT_MAPINDEX

        Optionele selectIndex/kaartindex (default: DEFAULT_MAPINDEX) waarop de selectie wordt overschreven.

      Returns void

    • Parameters

      • features: Feature<Geometry, { [x: string]: any }>[]

        Array van OpenLayers features die geselecteerd moeten worden.

      • layerName: string

        Naam van de kaartlaag waarop de selectie betrekking heeft.

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele selectIndex/kaartindex (default: DEFAULT_MAPINDEX) waarop de selectie wordt toegepast.

      Returns void

      Zet een selectie voor een specifieke kaartlaag. Bestaande selecties voor deze laag worden overschreven.

    • Parameters

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele kaartindex (default: DEFAULT_MAPINDEX) waarvoor de selectiemodus wordt ingesteld.

      Returns void

      Zet de selectiemodus van de kaart op single select. Hierbij kan steeds slechts één object tegelijk geselecteerd worden. Alle kaartlagen die de optie getFeatureInfoOnSingleclick aan hebben staan kunnen geselecteerd worden.

    • Start een selectie‑interactie op de kaart. Alle kaartlagen die de optie getFeatureInfoOnSingleclick aan hebben staan kunnen geselecteerd worden; via de layerIds optie kan hier nog verder op gefilterd worden.

      Parameters

      • options: SelectOptions

        Configuratie voor de selectie, zoals selectiemodus en aanvullende selectie‑opties.

      • mapIndex: string = DEFAULT_MAPINDEX

        Optionele kaartindex (default: DEFAULT_MAPINDEX) waarop de selectie wordt gestart.

      • selectIndex: string | undefined = undefined

        Optionele selectIndex (default: undefined) waarmee een select interaction wordt geïdentificeerd. Als undefined, dan wordt de mapIndex gebruikt voor de selectIndex. Met selectIndex kunnen meerdere select interactions actief zijn op 1 kaart.

      Returns void

    • Stopt de actieve selectie‑interactie op de kaart.

      Parameters

      • selectIndex: string = DEFAULT_MAPINDEX

        Optionele selectIndex/kaartindex (default: DEFAULT_MAPINDEX) waarop de selectie wordt gestopt.

      Returns void