v1.3.0 Update (03/01/2019)

Release Update v1.3.0 - March 1 2019

Changes

Update leaflet to version 1.4.0.

_xyz() instantiation will load the first locale if no locale is specified as parameter.

_xyz() instantiation will async load the workspace if no callback is defined.

Async instantiation:

const xyz = await _xyz({
    host: document.head.dataset.dir
});

Instantiation with callback:

_xyz({
  host: document.head.dataset.dir
  callback: xyz => {}
})

_xyz.workspace.loadLocale() will load a locale from the workspace.

_xyz.workspace.loadLocale({
    locale: 'GB'
});

_xyz.mapview.create() will load a locale if the locale parameter is given as parameter.

utils.paramstring() will not add empty keys to output.

utils.createCheckbox() returns the input.

utils.getCircularReplacer() Replace circular reference when stringyfying JSON.

utils.dataURLtoBlob() Return Blob from dataURL.

utils.turf.pointOnFeature() Return [lat, lng] coordinate pair from a point in polygon. Will also work with point geometry.

hooks.remove() will empty but not remove array hooks.

select hooks are retired.

locations are now stored in hooks.current.locations[].

The location hook will be removed if a location cannot be selected.

hooks.set() uses now Object.assign instead of a single key/value pair.

The _xyz.hooks object is structured as follows:

hooks : {
    current : {
        layers : [],
        locations : []
    },
    filter : ()=>{},
    push : ()=>{},
    remove : ()=>{},
    removeAll : ()=>{},
    set : ()=>{},
}

mapview.draw.geoJSON({})

Drawing GeoJSON to the map is now a drawing method on the mapview.

mapview.popup()

Will open a popup on the mapview. Content and latlng must be supplied as input param.

Locations

_xyz.locations has a select() method as well as location prototype object.

Calling _xyz.locations.select() with input parameters will create a location and get it's data from the XYZ middleware.

Without a mapview and no callback the select method will create an alert with the stringified infoj object.

With a mapview the location will be drawn to the map and a popup with the location view will be displayed.

A callback can be passed to the select method to control the display of the location view.

_xyz.locations.select(
  //params
  {
    locale: 'NE',
    dbs: 'XYZ',
    layer: 'COUNTRIES',
    table: 'dev.natural_earth_countries',
    id: 80,
  },
  //callback
  location=>{
    location.style.fillColor = '#f44336';
    location.style.fillOpacity = 1;
    location.draw();
    document.getElementById('location_info_container2').appendChild(location.view.node);
  }
);

location.draw() will draw the location to the mapview.

A location's own methods know their parent.

location.draw(), location.remove(), etc. do not need the location object as input parameter.

locations : {
    select : {},
    location : {
        infoj : [],
        geometry : {},
        Geometry : {},
        marker : {},
        Marker : {},
        geometries : [],
        remove : ()=>{},
        get : ()=>{},
        draw : ()=>{},
        view : {
            update : {},
            node : {},
            geometry : {
                ctrl : {
                    isoline_here : ()=>{},
                    isoline_mapbox : ()=>{},
                    delete_geom : ()=>{},
                    show_geom : ()=>{},
                    hide_geom : ()=>{},
                }
            },
            group : {},
            groups : {},
            streetview : ()=>{},
            images : {
                ctrl : {
                    add_image : ()=>{},
                    delete_image : ()=>{},
                    upload_image : ()=>{},
                },
            }
        }
    }
}

Addition of Table Definition

A selected location may have its own table view presenting relevant data. The visibility of the location can be toggled on and off.

The data is calculated against various additional geometries that are associated with the location. They can use values calculated within subqueries as well as fixed expressions not related spatially.

"infoj": [
  {
    "type": "tableDefinition",     // defines table
    "title": "Age Profile",        // required and unique within infoj
    "columns": [],
    "rows": [],
    "agg": []                      // optional
  }
]

title is required and must be unique.

tableDefinition has three children : columns, rows and agg