Map+

Overview

When to use it

Use Map+ when you need to:

• Monitor assets that are spread over sites, plants, or regions, with the status and values of each location on one map.
• Color markers and labels by limits or states, so that out-of-range locations stand out.
• Let operators jump between regions, open the trend of a clicked asset, or use a click to filter other symbols.
• Draw routes between assets, or add a KML, GPX, or GeoJSON file as an overlay.

Choose Asset Comparison Table+ when the location does not matter and you want to compare exact values side by side.

Before you begin

• Give every asset a numeric Longitude and Latitude attribute with a good value. In PI System Explorer, set the attribute Properties to Location > Longitude and Location > Latitude. Map+ reads the traits, not the attribute names.
• Use values from -180 to 180 for longitude and from -90 to 90 for latitude. An asset without valid coordinates has no marker.
• The browser of every viewer must be able to reach the map tile server. Map+ loads its base map from a third-party provider, so a display on a network without internet access shows no map.

Add and set up the symbol

1. Select Map+ in the PI Vision symbol gallery.
2. Drag an AF element that has the location attributes onto the display. The symbol shows that asset at its location.
3. Right-click the symbol and select Add Dynamic Search Criteria.... The Search Criteria pane opens.
4. Set Search Root (1) to the element that holds your assets and Asset Type (2) to their template. Check Number of Results (3).
5. Select Refresh (4). The symbol loads every matching asset.
6. Close the pane. Each asset appears as a marker at its location, with its values in a label.

To show a fixed set of assets instead of a search, drag each asset onto the symbol.

Common tasks

Choose a base map

Use this when the default street map does not suit the display, for example when a quieter gray map makes the colored labels easier to read.

1. Right-click the symbol and select Configure Map....
2. Open Map.
3. In Provider (1), select Arc GIS (Esri).
4. In Style (2), select World Gray Canvas.

The base map changes at once. Open Street Map and Arc GIS (Esri) load without a key. For Map Box, a field for your own access token appears under Style.

Show names and values in the labels

Use this when a label must say which attribute a value belongs to, or which asset it belongs to.

1. Open Data Labels.
2. Set Name (1) to ON to print the attribute name before each value.
3. Set Asset (2) to ON to print the asset name above its values.
4. Set Line (3) to ON to draw a line from each label to its marker.

Each label now shows the asset name, then one row for each visible attribute, such as Speed and Power. Use Time to add the timestamp, and Start Hidden to open the display with the labels off.

Color markers and labels by limits

Use this when operators must see at once which locations are low, normal, or high.

1. Right-click the symbol and select Configure Multi-State....
2. In Current Attributes, select the attribute (1), for example Value 1.
3. Select Enable Multi-State (2). The attribute's limits and their colors (3) appear under States.
4. Right-click the symbol, select Configure Map..., and open Series.
5. Next to Color (1), select Attribute. In the list below (2), select the same attribute.

The marker and the label background take the color of the state that the current value falls into.

Group nearby markers into clusters

Use this when many assets lie close together and their markers and labels overlap at the zoom level you need.

1. Open Clustering.
2. Set Enabled (1) to ON.
3. Raise Threshold (2) to group more markers, or lower it to group fewer.
4. In Aggregation (3), select how the cluster's values are calculated: Mean, Min, Max, Sum, or Count.
5. In Symbol (4), select a different marker for clusters, so that they differ from single assets.

Markers that are close together become one marker. With Asset on, its label reads, for example, "3 Assets (Mean)" and shows the aggregated values. Zoom in and the cluster splits into single assets.

Add a view for a region

Use this when operators need to jump to a region in one click.

1. Pan and zoom the map to the region.
2. Open Views and select Add View (1). A view named New View appears with the current map section.
3. Enter a name for the view (2).
4. To change a view later, move the map and select Apply Current View (3) on that row.
5. To set the section the display opens with, set Default View to Saved View, move the map, and select Save Current View.

A button with the view name appears at the bottom right of the map. Selecting it moves the map to that section and highlights the button. The home button at the top right returns to the default view.

Open a trend when an operator clicks an asset

Use this when operators should see the history of a location without leaving the display.

1. Open Asset Selection.
2. Check that Enabled (1) is ON.
3. In Action (2), select Quick Trend (Dialog).

Select a marker. A trend dialog opens with the asset name as the title and one trace for each visible attribute, over the display time range.

Other actions: Filter publishes the asset to other symbols (see Filtering dashboards). Ad Hoc Chart (Window) opens the values in an ad hoc chart window. Set asset context swaps the asset context of the display to the clicked asset, so that symbols relative to the context follow. Open Hyperlink opens a display or URL, with the asset path appended for a custom link.

Use the symbol

• Click a marker to run the configured action. Selecting a cluster applies the action to all assets in it.
• Hover a marker to see a tooltip with the asset name and the value of each visible attribute, with its state color.
• Values: labels show the value at the end of the display time range, unless the attribute is set to a calculation over the range.
• Auto View Cycling: when it is on, the map moves through the views by itself. Start or stop it with the button at the top right. Clicking a view button, or pressing the mouse on the map, stops it.
• Edit mode: the map does not respond while the display is in edit mode. It shows "Exit edit mode to interact with the map".
• No assets: a search without results shows "No assets were found. Modify the search criteria."
• Writes: viewing never writes data. Panning and zooming are not saved. A click action that sets the asset context or publishes a filter changes other symbols on the display. Only Save in the Assets section of the pane writes to the PI System (see Assets).

Configure the symbol

Right-click the symbol and select Configure Map.... Groups appear in this order.

Map

Series

Data Labels

Tooltip and Legend

Clustering

Views

Asset Selection

Filtering

Attributes

Select an attribute in the list, then set:

Lines

Assets

Available when you added the assets by dragging, not by a search.

Map Files

Style

Troubleshooting and limitations

Limitation: Map+ draws one point for each asset, at the location it has at the end of the display time range.

Limitation: The base map comes from a third-party server. Availability, terms of use, and usage limits depend on the provider.