Termen & begrippen

Werken met coordinaten

polka/examples/datatypes/coordinates.js
export const coordinates = (polka) => {

    /**
     * Coordinate{Array.<number>}
     * An array of numbers representing an xy coordinate. Example: [16, 48].
     */

    /** 
     * coordinaten in Eindhoven
     * [ x, y ]
     */
    const Eindhoven = [162833.06448813833, 386140.48611484875];

    /**
     * template string with `{x}` and `{y}` placeholders
     * that will be replaced by first and second coordinate values.
     */
    const string = polka.utils.coordinate.format(Eindhoven, "Eindhoven: {x} {y}");
    console.log(string);

};

Zoom niveau

Zoom niveau 0: De kaart bekeken vanuit de stratosfeer Zoom niveau 15: De kaart bekeken vanaf dak hoogte

Projectie

Een kaartprojectie is een wiskundige afbeelding die het aardoppervlak (of bijvoorbeeld het oppervlak van een ander hemellichaam) of een deel daarvan over te brengen op een vlakke kaart. Als wordt afgezien van de afplatting van de Aarde, is dit een afbeelding van een boloppervlak of een deel daarvan op een plat vlak.

Meer informatie over het Rijksdriekhoestelsel en projectie.

Werken met projecties

polka/examples/datatypes/transform.js
export const transform = (polka) => {

    /**
     * "GPS" Coordinaten (EPSG:4326) van Eindhoven [lat, lon]
     * @see https://epsg.io/4326
     */
    const Eindhoven = [5.499921405840683,51.46427760915219];

    /** als Point */
    const point = polka.utils.Point(Eindhoven);

    /**
     * transformeer naar RD coordinaten (EPSG:28992)
     * @see https://epsg.io/28992
     */
    const coord = point.transform('EPSG:4326', 'EPSG:28992').getCoordinates();
    console.log(`lat/lon ${Eindhoven} naar RD ${coord}`);

};

Bind

De methode bind() maakt een nieuwe functie aan die, wanneer deze wordt aangeroepen, het this-sleutelwoord heeft ingesteld op de opgegeven waarde, met een gegeven reeks argumenten die voorafgaan aan de opgegeven wanneer de nieuwe functie wordt aangeroepen.

Bron: MDN Web Docs

Eventlistener

Een eventlistener zorg ervoor dat een functie word geactiveerd op het moment dat de actie waar de eventlistener naar kijkt word uitgevoerd.

Voorbeeld: The addEventListener() method

Subscribe

Een subscription is een object dat een beschikbare hulpbron vertegenwoordigt, meestal de uitvoering van een observable.

bron: RxJS subscription

Slider

Form input veld welk een schuif weergeeft.

voorbeeld: JS rangeslider

Marker(s)

Marker ook wel pin genoemd is een visuele markering op de kaart van een punt, getoond na zoekopdracht en/of klik op de kaart.

Measure

Het opmeten van een lijn of oppervlakte.

Kaart/viewer

De kaart weergave op de pagina.

Layers/kaartlagen

De kaart word over het algemeen opgebouwd uit meerdere lagen die boven op elkaar worden getoond. Het is daarom van belang dat de volorde van de kaartlagen coorect is ingesteld in het dashboard.

Base Layer(s)

Het is (vaak) wenselijk om een of meerdere kaartlagen als een ondergrond laag te hebben. Dit zijn lagen zoals het stratenplan of de luchtfoto. Deze lagen dienen om context te geven aan de getoonde informatie van de andere kaartlagen. (locatie/omgeving ect.)

Viewer.view

Visuele kaart object binnen polka. Hierin hebt je toegang tot o.a. de kaartlagen, marker, positie enz.

Viewer.view.animate (beweeg naar punt)

Deze functie zorgt ervoor dat je naar het aangegeven punt [X, Y] gaat op het aangegeven zoom niveau.

Viewer.view.zoom

geeft huidige waarde van het zoomniveau terug en kan gebruikt worden om het zoomniveau te wijzigen.

viewer.features

Wanneer de gebruiker op de kaart klikt, worden de objecten die op dat punt liggen geselecteerd. De collectie geselecteerde objecten is beschikbaar onder polka.viewer.features.selection

Viewer.view.map

Onderdeel van de viewer.view. Hierin bevinden zicht de kaartlagen. Aanroepbaar met polka.viewer.view.map.layers

Viewer.view.map.events

Het klikken op de kaart kan je afvangen met events.

const events = application.viewer.view.map.events;
events.addEventListener("map.click", (e) => {
    ..code..
}

Viewer.view.map.layers

Object met alle kaartlagen binnen de viewer. Ittereer over dit object om de eigenschappen en instellingen per kaartlaag te lezen/wijzigen. Beschikbare eigenschappen zijn:

Visible/show_layer

het wel/niet tonen van de kaartlaag

Opacity

De transparantie van de kaartlaag. 0 == volledig transparant - 100 == geen transparantie.

Name

Kaartlaag naam