Home > WebEOC > Admin Guide > Mapping > Enable Boards to Use Maps

Enable Boards to Use Maps

Any number of status boards can be geospatially enabled to work with Maps. Three boards included in the initial WebEOC board set come pre-configured to work with Maps: Event Reporting, Shelters, and Road Closures.

For a board to be enabled with Maps, it must have feature tags added. Enabling Maps for a board involves adding feature tags to input and display views. You can add one or multiple feature tags to a board and define attributes for each, controlling the map label, status color, presentation as a link or button, and more. There are also several different methods that you can use to add these feature tags to a board and enable it for Maps.

This section outlines some of the options available to enable Maps for a given board. For technical support, contact the WebEOC Support team. If preferred, contact your CSM to arrange for the configuration of Maps-enabled boards by members of our Professional Services team.

Mapper Boards

If you use Mapper Lite or Mapper Professional, any existing boards that you have configured to work with those solutions are not automatically converted to work with Maps. Instead, Maps-specific feature tags must be added to these boards to enable the improved capabilities. The use of these new tags allows boards to work with both the legacy Mapper products, using the old Mapper tags, and the Maps solution, using the feature tags. The latest versions of Mapper Lite and Mapper Professional also include a feature that allows you to convert your existing board data to the format required for Maps.

Feature Tags

<feature> tags are used to create fields on the board for storing feature data, including points, lines, polygons, and circles. When used, these tags render a button or link on the specified board that can be used to open the map.

The table below outlines the various Maps-specific feature tag attributes that you can use to help define elements on a board.

Note: Certain attributes can be applied to both input and display views, while other attributes can be applied to either input or display views. The View Type column in the following table indicates how these attributes can be used.

Attribute

Value

Restriction

View Type

Description

address

%fieldname

Optional

Input

Name of the field that contains an address. This tag is useful for automatically geocoding the address upon opening the map. The attribute can be called address or address-field.

autopopulate

true, false

Optional

Input

A utopopulates the feature from the data entered in the address field or the latitude and longitude fields.

icon-mode

icon, label, none

Optional

Display

Specifies the type of icon or label that appears with the feature on the map. If you specify none, no icon or label appears with the feature, but a tooltip appears when the user points to the feature.

label-field

%fieldname

Optional

Input

Specifies the field that provides the label used on the map for the feature.

latitude-field

%fieldname

Optional

Input

Specifies the field that provides the latitude of the feature when autopopulate is used.

locate

true, false

Optional

Input

If set to true, your current location is automatically shown when the map view is opened.

longitude-field

%fieldname

Optional

Input

Specifies the field that provides the longitude of the feature when autopopulate is used.

map

%mapname

Optional

Display

Input

Specifies the map that users are directed to; when not defined, the default map is used.

name

string

Required

Display

Input

Name of the feature field; the underlying geography column name in SQL Server.

shape

point, line, polygon, circle

Optional

Input

Specifies the default feature type selected; may be changed by the user after opening the map, unless tools are disabled. When not defined, a point is used.

status-field

%fieldname

Optional

Input

Specifies the field that indicates the status for the feature; uses list colors and/or icons on the map when defined.

target

%embedmap id

Optional

Display

Results in panning/zooming to the record when clicked. Used with the <embedmap> tag; value should be the embedmap ID.

tools

none, all

Optional

Input

If set to none, the only drawing tool visible on the edit page is the feature type specified in the shape attribute. If the tool attribute is not used or is set to all, all drawing tools are available to the user.

type

button, link

Optional

Display

Input

Specifies how the tag renders, either as a button or link.

These tags are put to use in the examples below to help you add a basic map link, an address field, and multiple address fields.

Basic Map Link

Adding a basic map link that opens up your default map from an input or display view involves adding the following feature tag to the board's input view:

<feature name="location" type="link" class="webeoc-link">
<i class="icon-map"></i>Map
</feature>

webeocenablemapboardsbasicmaplink.png

The workflow with this tag would, for example, allow you to click the Create button associated with the board followed by a Map link in the Edit window. Once the Map link is clicked, a map would open on the board and allow you to define the point, line, polygon, and so forth associated with the board record.

On the display view, you can use the feature tag to control the styling of the link or button, setting your own styles or using the <eocfield> tag for default styling. The default styling, <eocfield name="location"/>, includes a Map button.

Address

Including a field that allows you to enter an address and then map that address by clicking a link would involve adding the following to the board's input view:

Address: <input type="text" name="address"></input><space/>
<feature name="location" address="address" type="link" class="webeoc-link">
<i class="icon-map"></i>Map</feature>

The workflow with this tag would, for example, allow you to enter an address in a single field and then click a Map link.

Auto-populate

Including a field that allows you to enter an address and then auto-populate the feature would involved adding the following to the board's input view:

Address: <input type="text" name="location"></input><space/>
<feature name="location" address="address" autopopulate="address" type="link" class="webeoc-link">
<i class="icon-map"></i>Map</feature>

The workflow with this tag would, for example, allow you to enter an address in a single field and then populate the feature with no further user action. If an exclamation point icon appears, multiple addresses were found and the user could click the Map link to select the appropriate address from the options listed.

Multiple Address Fields

Adding a tag that allows you to enter address information in multiple fields would look something like the following:

Maps_multipleaddressfieldtag.png

The workflow with this tag would, for example, allow you to enter address information in multiple fields and then click a Map link.

You must to post a comment.
Last modified

Tags

Classifications

This page has no classifications.