Configuration of Embedded maps

Configuration of embedded maps

As an administrator you can choose which base map that will be accessible to users with and without rights. One can choose which coordinate system solution to use and whether to use BAAT or not. Note that these settings are generic and that any changes will apply to all embedded maps created after the settings are changed!

config-embedded-maps

Name Description
embedded_basemap_guest List of base map that is available to users with special rights
embedded_basemap_admin List of background maps are available for administrators and users with rights
embedded_cfg Coordinate system used in the solution. Standard is UTM33.
embedded_basemap_usebaat Shall base maps be created by administrators and users with rights use BAAT? Standard threaten.

Embedded maps use Leaflet as map engine, see http://leafletjs.com/ for more information. Any limitations on the leaflet will determine which background map and theme supported. Coordinate in use must be supported by proj4leaflet.

Embedded maps

Embedded maps

embedded-maps

The Button “Embedded maps” allows you to view and delete the embedded maps created in the solution.

Embedded maps are miniature maps for use on their own websites and blogs, as users themselves have created via the “Share” module.

As a guest or user with special rights one can by default create a miniature map with two types of background maps; respectively. standard and grayscale. These background maps using the open services at the Kartverket.

As an administrator or privileged user you can create a miniature map that uses two types of background maps; respectively. Standard, grayscale and Norway in pictures. By default, background maps created by such users use BAAT.

All WMS which is activated when the user creates an embedded maps will be included, even those who are defined through ‘own data. ” All activated drawn objects and associated text comes with.

Coordinate used in the solution is WGS84 UTM Zone 33. All background map and WMS added to an embedded map must support this coordinate system. Standard coordinate system can be changed (see “Configuration of embedded maps”).

Have an administrator access can also create special embedded maps with custom coordinate system, ​​background maps, WMS and vector data. Contact support@avinet.no for more information.

 

Dimension

Dimension

Gives the user the ability to filter data displayed in map and table view (only Wms dimension) based on time (Time) or other attributes (WMS dimension).

Time dimension

Allows the user to make the selection of a theme using a “slider” in the map. When the user activates an issue that has time dimension shows up a slider at the bottom of the map that the user can use to extract data from a specified time.

Time dimension is supported only for PostGIS based theme. The theme must have a date column that contains dates or times as it is about the user to make selections from.

Navn Description
Time dimension field column that contains date or time that indicates time. Date column must be of type date or timestamp without timezone (note that timestamp with timezone is not supported!).
Default value Here, but choose what time that will be default. This default value is used if the topic is presented without a date is set for the URL. In map client hour suffering is always last time used as default. This is suitable where there is a data set that dynamically receive new data.
Show timeslider One must check here that the topic should be controlled via time slider in Adaptive. If one wants to create a theme that supports dimension, but does not want to show time slider in adaptive client can do that by turning off the checkbox “showtime slider.” For example. applicable on the subject should be used in external WMS.
Automatic update By ticking here will unique values ​​for time updated by indexing theme. This will be appropriate where the underlying data update with new values ​​in the database.

Time slider in Adaptive map client allows the user to move the position by dragging the yellow time marker. In addition, you can zoom in slider by using the mouse scroll wheel. One also has the opportunity to “play” time in slider by making choices in the extended menu. There you can put ‘step’, how far one should jump in time displacement, and “interval”, how long to display data before moving to the next stage.

Wms dimension / filter

Allows the user to filter a theme by selecting which values one wishes to display a set of attributes. To control filters for a theme you must add the gadget “Layer dimension / filter” in the current GUI. When a theme is turned on, the possible filters for this when presented in this module so the user can filter the data. This filter will filter both what you see on the chart and what appears in table view (data view).

Limitations

Wms dimension is supported only for PostGIS based theme. As of today, supported columns of data type text or integer. When it comes to textual values then there are some characters that have special meaning to map the engine and therefore can not be used in values in a selected column.

This applies to the following:

  • , -A comma is used as a delimiter
  • / -Slash used as interval delimiters
  • & – Used as a delimiter between URL parameters and will also create trouble in XML from GetCapabilities
Tip

To avoid these special characters in a column that is to be used as a filter column one can modify the query for the theme.
If the query is on the form:

SELECT * FROM table

If there is a column “original_value” with special charachters one can use PostgreSQL’s “replace” function and create a new modified column.
Example:

  • replace ,:
    SELECT *, replace(original_value, ',', ' and ') as modified_value FROM table
  • replace /:
    SELECT *, replace(original_value, '/', ' or ') as modified_value FROM table
  • replace &:
    SELECT *, replace(original_value, '&', ' and ') as modified_value FROM table

Name Description
Show dimension filter One must check here that the theme filter to appear in the module “Layer dimension / filter” when it is turned on.
Dimension group name Here you add a common name for several topics that share one or more identical filter columns. If you turn on several topics in Adaptive client that has the same group name here, these are collected in a “filter control” so that choices made for filtering will apply to any theme with common group name. Topics that have common group name can still have unique filters, and these will only filter the topic that has the selected filter column. NB! Topics that are grouped in this way may not have columns with the same name but with different values.
Tabell med oversikt over filter kolonner Table of filter columns Displays a tabular listing of filters that are set on a theme. To add a filter, click on “+” button at the right side table. To edit a existing filter select the appropriate row. To delete a filter, click on “-” button for current row.
Edit grid items in this form Form to edit some column filters.
Column name (required) Here you select the column you want to filter. The column must have the data type “text” or “integer”.
Default value (Optional) You can enter a default value that will be used if the parameter is not put in a call to the topic. This value will also be the default selected in the filter drop down in the filter module (but the theme will not be filtered before you click “Insert filter”).
Extent (Required) This lists love values ​​that can be used as filters against selected Column name. Listed values, separated by commas.Special characters which can not be used as part of a value is the following:

  • , – A comma is used as a delimiter
  • / – Slash used as interval delimiters
  • & – Used as a delimiter between URL parameters and will also create trouble in XML from GetCapabilities

Clicking Update extent from unique values ​​will all unique values ​​that exist in selected Column name is entered as a comma separated list. This means that all these values ​​are legitimate filter values. If a Dictionary theme is set up to the unique values ​​from Key column from the selected dictionary.

 

Extent can be set up with the following syntax:

  • value – A single value (text or integer)
  • value1,value2,value3,… – A list of multiple values ​​(text or integer)
  • min/max – An interval defined by a from and to value (only integer)
  • min1/max1,min2/max2,min3/max3,… -A list of comma-separated interval (only integer)
Automatic update (Optional) By checking here will unique values ​​for Extent updated by indexing theme. This will be appropriate where the underlying data update with new values ​​in the database. NB! manually typed values ​​will be overwritten by indexing.
Update extent from unique values Click here to retrieve possible values ​​for Extent of underlying data. Clicking UPDATE extent from unique values ​​will all unique values ​​that exist in selected Column name is entered as a comma separated list. This means that all these values ​​are legitimate filter values. If a Dictionary theme is set up to the unique values ​​from Key column from the selected dictionary.

 

Update extent from unique values By making choices here will be able to use an existing theme / code list values ​​for a filter. This can be useful where there is an “id” field in a theme and you have another topic that contains the “id” and “name” so that users can relate to names instead of id by filtration.

Example of use:

One has a dataset with a column “Artside.” This field contains integer values ​​that says something about art. In order for a user to filter the art, it is useful to know which species are behind a “Artside.” If one then sets up a theme, eg “Species”, which reads data from a table that has both “Artside” and “species name” you can use this as dictionary with the following configuration:
Dictionary theme: Species
Key column: Artside (or other id field corresponding to “Artside” column in the topic you want to filter)
Value column:species name (or other text fields that have a description of the species in question)

Dictionary theme (Required only when dictionary in use) Here you can choose a PostGIS themes to be used as dictionary.
Key column (Required only if dictionary in use) Values ​​found in the Key column are the actual values ​​that will be used to filter a theme. Unique values ​​of Extent will also be collected from this column when using dictionary.
Value column (Påkrevd kun om dictionary er i bruk) values ​​contained in the Value column is the descriptive text / name presented to users who want to filter a theme.

 

 

Filter module shown in Adaptive client could look like. In all cases where there is a list of possible filter values, these are displayed in a dropdown list. Here you can choose to filters on one or more values. If the list is long, you can start writing the value for suggestions that one can choose from. To activate the filter, click on Insert filter and to remove the filter, click on Remove Filter. If one has set a default value will see a button labeled Set default values set selected values to what is set as default in admin.

Del filter lenke (Admin)

Administrator users will get an extra choices under each filter group: Share filter link

This creates a URL to the solution that will turn on the filter for topics in the filter group at the start of Adaptive. The themes will be filtered, but not enabled, then there are other URL parameters to turn on the theme.

Example URL parameter filter:
– http://[rot url]/[gui navn eller uuid]?av_filter=%5B%7B%22t%22%3A24%2C%22f%22%3A%5B%7B%22k%22%3A%22kommunenr%22%2C%22v%22%3A%5B%220101%22%2C%220104%22%2C%220105%22%5D%7D%5D%7D%5D

The filter is located in the URL parameter av_filter. Filter value is URL encoded to ensure that values are not able to create problems for the URL.

Decoded see the value like this:

[{"t":24,"f":[{"k":"kommunenr","v":["0101","0104","0105"]}]}]

URL parameter is an array of filters that are constructed with the following structure:

[
{
	"t": "themeid 1",
	"f": [
		{
			"k": "kolonnenavn",
			"v": ["filter verdi 1", "filter verdi 2", "filter verdi 3"]
		}
	]
},
{
	"t": "themeid 2",
	"f": [
		{
			"k": "kolonnenavn",
			"v": ["filter verdi 1", "filter verdi 2", "filter verdi 3"]
		}
	]
}
]

Basemaps

Basemaps

basemap

The above example shows window to establish background map (base theme) in a GUI. The window shows two panels separated by a vertical splitter. Left panel contains a table with all basemaps available in Adaptive, while the right panel contains all the basic map that is enabled in the current GUI. The panel has the ability to search/filtering.

New base maps are added by drag-and-drop. Basemaps order in Adaptive is determined by the order in the right panel. Order changes by drag-and-drop. When the symbol appears it means that the background map can be dropped at designated place, while symbol means that the background map can NOT be created at the specified place.

To remove a base map from a GUI right mouse button click and choose “remove”. This does not delete the base map, but removes it only from the GUI a. Alternatively checkboxes “Active” is used. It will deactivate current base map of GUI.

Categories

Kategorier

kategori

Here you select which categories (thematic maps) that are available in the current GUI. The functionality to add new and remove categories are similar to base maps.

Info modules

Info modules

Info modules are used to create a page with custom content in the right frame of adaptive. The page is created in the administrator, while the content is edited by one or more users with rights.

info-module-example

As an administrator, there are basically three important settings one must put, hhvs. language header in the module (where it says “Information” in the above screenshot), and language button (text and tool tip). In addition, one must set permissions.

info-modules-permissions

Rights works the same way as for digitizing theme, for each role one set it must define whether users associated with what role should have access or editing options (read/write). Note that “Standard and Admin read / write” here means the same.

Drag and drop the info page of all GUI where one wants to see this.

kategori

 

Google Analytics

Google Analytics

The module must be installed in particular. If it is not available in the administrator, send an email to support@avinet.no and we will install it for free.

The module requires a free account at Google. You need to create a tracker ID to be associated module, then one must take over the widget in all GUI where you wish to log traffic. See https://www.google.com/analytics for more information

google-analytics

To retrieve a new tracker ID, log into https://www.google.com/analytics/web and click Admin. Then click on the property -> create new property.

google-analytics-table

Then enter the administrator, click GUI -> Add elements. Find the module called “Google Analytics”, usually by searching for google. Right-click the appropriate module and select “Set tracker ID.” Please enter the tracker ID and select OK.

google-analytics-add-module

Drag and drop the module into any GUI where you wish to log user data.

Moduler

Moduler

Modules in Adaptive 3 builds up on relevant GUI with functionality. There will be varying which modules are available, for example, some modules may be subject/customer specific and will only be available for certain customers.

modules

Here you select which modules that are available in the current GUI. The functionality to add new and remove modules are similar to base maps.

Below is a list of information about the modules.

Name Description
Search Search on location name, street addresses and theme data
Mouse coords / scale Showing mouse arrow coordinates in selected coordinate system and the scale display. Provides the ability to adjust the scale.
Authentication Provides the option to login and choose a language.
Navigation buttons Provides four buttons, zoom inn/out, zoom full out and locating.
Layer manager Provides standard thematic map select.
Share Allows for printing, sharing maps on social media, link to map view and export to GeoJPG.
Data view Data view – Allows viewing of a themes properties in a table. Concurrently put the solution in selection mode. Selected objects can be exported. Applicable Shape and database-based theme.
Legend Provides legend on active theme.
Map info Provides, by click-to-map, property info on active theme and coordinates/elevation and the nearest place names for current coordinate.
Draw and measure Allows plotting point/line/polygon and measurement of length/area.
Draw and measure – advanced Allows plotting point/line/polygon and measurement of length/area. Each can have a buffer meters from the marked line, point, or polygon. Here you can also adjust line thickness, choose color freely and symbol type.
User data Allows the user to add WMS based theme and pretend the KML and GPX.
Attribution Showing referral/copyright text for active background map. Appears in the lower right corner.
Layer Manager PRO Advanced theme choice. Allows to turn the theme across thematic maps/categories.
User Workspaces Allows you to save the current map section.
URL API Allows you to manipulate maps using one set URL parameters. Relevant parameters can be combined. examples:

basemap=7
ID (integer) on the background map to be activated. Ignored if it does not exist.

cat=1
ID (integer) on thematic maps/category to be activated. Ignored if it does not exist.

themes=1,2
Comma separated list of topic (IDs) to be activated. Ignored if they do not exist. The themes are activated only if they exist in thematic maps/category (cat parameter).

digithemes=1,2
Comma-separated list of digithemes (IDs) to be activeted. Ignored if they are not found. The themes are enabled only if they exist in theme card/category (cat parameter).

subcats=1,2
Comma separated list of subcategories (IDs) is to be activated. Ignored if they do not exist. Subcategory activated only if they exist in thematic maps/category (cat parameter).

zoombox=275427.5,6653023,276871,6653668.89,32633
Zoom to extent/box/corner coordinates. Syntax: left, down, right, top, EPSG

zoompoint=11.0216,59.9576,4326,5,test
Zoom to Point. Syntax: Point coordinate, EPSG, zoom level (not scale but values ​​from eg 1 to 16 depending on the limitation put on GUI), text displayed in pop

Map info tool – Weather forecast Weather forecast – Allows to display weather from Yr.no by click in map.
Map info tool – Sunrise/sunset times Sunrise/sunset times – Allows display times for sunset/rise by click in map.
Map info tool – Lovdata lookup Allows to display Lovdata regulations relevant area by click the map.
WMS time slider
Map info tool – Marinogram Allows to display Marinogram from Yr.no by click in map.
Refresh data Opens the possibility to update one theme or table by clicking a refresh button.
Map info tool – Elevation profile Allows to extract elevation profile for a selected stretch of map.
Digi theme meda tool Provides ability to upload and view media files in digital theme.
Map info tool – Census Allows to extract census information from clicked position in the map.
Report module Allows you to generate a report in PDF format based on the drawn areas and selected thematic data.
Matrikkel Provides search gnr/bnr and other matric functionality
Matrikkel Provides search on owner and other matric functionaltiy
Matrikkel Provides search on unique building numbers and other matrikkelfunksjonalitet.
Forum Allows to create, modify and moderate the discussions.
Directions – Norway Allows to calculate and plan journeys by click to select location or search for a given position. Shows routes and alternate routes in maps and prints out driving directions. In addition, you get marked tolls, ferries, rest areas and traffic information of the map. Also contains a link to the timetable for any ferries on the route.
Google Analytics Logging page views and background maps, themes and modules in use. See separate chapter.
School Transport Allows you to calculate the route to school from a given address to a selected school.
Statistical client Allows for viewing of statistical data in the map.
ToolPageModule Tools Module. Editable if the user have the necessary rights.

Indexer

Indexer

indexer

Data to be searched in Adaptive must be indexed, this is done by clicking on the button marked in red in the image below.

Screenshots below shows the status of indexing.
table-indexer

Name Description
ID Unique ID of the item.
Type Type dataset.
Details Name of the dataset
Queued time set in indexings queue
Last update Time for last indexert.
Status Displays the status of the last indexing
Trace Displays an icon when something has gone wrong, click on this to see details.
Entries Number of objects indexert.
Progress Shows progress on indexing.
Schedule How often indexing is scheduled.

To index addresses click the index-addressesand place-name, and click on  index-names. Is it desirable to re-index the one theme select the row and click re-index.  To re-index all theme click on re-index-all. If you have made a scheduled index on one theme can be changed by clicking on edit-schedule, then the following window will appear:edit-index-form

Here you can choose how often you want the theme to be indexed. To delete a scheduled index click the delete-index.

Note! To index the “Themes” and “Digi Themes» read more in the respective chapters.

Projections

Projections

projections

Button “Projection” lets you view, edit, delete and create new “projections” in Adaptive. These are definitions of coordinate system. These will be used in various locations in Adaptive, for example, the theme when choosing the coordinate relevant data exists in.
table-projections

Name Description
EPSG EPSG code.
Name One name, used in pull-down menus
Description A description

You can also create new entries by pressing the button add-btn.add-projection

Name Description Changeable
EPSG EPSG code. Yes
Name One name, used in pull-down menus Yes
Description One description Yes
Definition Definosjon according to PROJ4. YesSe

See http://spatialreference.org for furter informasjon and definisjon. For example this http://spatialreference.org/ref/epsg/25833/ for informasjon about ETRS89 UTM sone 33n.