Map+ for AVEVA PI Vision

PI Vision map for AF assets and process data

Place your plants, stations and wind turbines on a geographic map in PI Vision. Map+ positions each AF asset from its latitude and longitude, shows its values in a label and colours it by multi-state, with clusters and saved views for wide networks.

Request a trial Explore Vision Library+

Read the Map+ documentation →

Map+ in AVEVA PI Vision showing Toronto, New York City and Mexico City on an Esri World Street Map, each with a label of its values coloured orange, red or green by multi-state and a pulsing marker for New York City, next to the Configure Map pane with Provider Arc GIS (Esri) and Style World Street Map
Map+ v2.0 in PI Vision with its configuration pane. Demo data. Select the image to enlarge.

PI Vision map for AF assets and their values

Map+ reads where each asset is from AF and shows the attributes you choose at that location, so a regional network reads at a glance.

Assets placed from their AF location

Give each AF element a latitude and longitude once, and every display that uses Map+ places it correctly.

  • Latitude and longitude from AF attributes with the Location Latitude and Location Longitude traits.
  • Drag assets onto the map, or use Search Criteria so new assets of a template appear automatically.
  • Several attributes per asset, each as the current value or a Total, Average, Minimum, Maximum, Count or Percent Good over the display time range.
  • Data labels with the asset, attribute name, value and time, placed automatically, in a fixed direction or by hand; a map button shows or hides them.
Map+ on an Esri World Street Map of North America with labels for Toronto, New York City and Mexico City, each showing two percentages, a tonnage and a status text, with view buttons for Europe, North America and South America
City assets placed from their AF latitude and longitude, with their values. Demo data. Select the image to enlarge.

Markers, pie charts and direction arrows

Choose how each asset appears, from a simple dot to an arrow that points the way the wind blows.

  • Circles, squares, triangles, diamonds, pins or arrows, fixed or taken from an attribute such as a status.
  • Arrows rotated by an attribute, for example a wind direction.
  • Marker colour and size fixed or from an attribute.
  • Pie charts that split an asset’s values, labelled with value, percent or both.
Map+ on OpenStreetMap showing an offshore wind farm: turbine arrows rotated by their wind direction and coloured green, orange or magenta, each labelled with wind speed in m/s and power in kWh, next to the Series settings with Type Scatter, the arrow symbol, Direction on with its attribute and Color from the Power attribute
Wind turbines as arrows rotated by their direction attribute. Demo data. Select the image to enlarge.

Multi-state markers and clustering on the map

Show which sites need attention and keep dense regions readable.

Multi-state colours on the map

Colour every marker and label by the PI Vision multi-state of the attribute that matters, so a site in alarm stands out on a wide map.

  • Multi-state per attribute, configured with the familiar PI Vision state ranges.
  • Blinking states pulse on the map to draw attention.
  • Hide an attribute from labels and tooltips and still use it for the colour.
  • Show or hide assets with no data, and add a legend.
Map+ with Toronto and Mexico City in red and New York City in blue, coloured by the multi-state of their first attribute, next to the Configure Multi-State pane with the current attributes, Enable Multi-State and the states Bad data, Maximum, HiHi, Hi, Lo, LoLo and Minimum
Labels and markers coloured by multi-state. Demo data. Select the image to enlarge.

Clusters for dense asset sets

Combine assets that sit close together into one marker with a summary, and see the individual assets again as you zoom in.

  • A proximity threshold decides when markers combine.
  • The cluster label shows the Mean, Minimum, Maximum, Sum or Count of each attribute.
  • Cluster markers can grow with the cluster and use a symbol of their own.
  • Lines between two assets and overlays from .kml, .gpx or .geojson files add pipelines, routes and boundaries.
Map+ zoomed out over the wind farm with nearby turbines combined into clusters whose labels show the mean direction, wind speed and power, next to the Clustering settings with Enabled on, Threshold 1.5, Aggregation Mean, Dynamic Size on, Factor 1 and Symbol Inherit
Clusters with the mean of each attribute. Demo data. Select the image to enlarge.

Map providers, saved views and interaction

Pick the base map that suits the display, guide users to the right region and let a click on a site lead to its data.

Map providers, styles and saved views

Use a street, topographic or satellite base map, save the views operators need and decide what a click on a site does.

  • OpenStreetMap, OpenTopoMap, Esri ArcGIS (World Street Map, World Imagery, World Topographic and more) or Mapbox with your access token.
  • A default view that fits all assets or a saved one, a home button and a button per saved view.
  • Auto view cycling moves between saved views, for example on a control room screen.
  • A click on a site opens a quick trend or ad hoc chart, filters other Vision Library+ symbols, sets the asset context or opens a display or URL.
Map+ settings: Provider Arc GIS (Esri) with Style World Street Map, and the Views settings with Default View Custom, Save Current View, the saved views Europe, North America and South America, Auto View Cycling, Start on Load, Animate, Transition Time and Buttons
Map provider and saved view settings. Select the image to enlarge.

PI Vision map examples

Four common ways teams use Map+ on their displays.

Production sites overview

Data
Site elements with location traits, production rate and a status attribute
Settings
Search Criteria on the site template, multi-state on status, clustering with Mean
Shows
Every site coloured by status, with regions summarised until you zoom in

Wind farm

Data
Turbines with wind speed, wind direction and power
Settings
Symbol Arrow, direction from the wind direction attribute, colour from power
Shows
Arrows pointing with the wind, coloured by output

Pipeline network

Data
Compressor or pump stations with pressure and flow
Settings
A line per section from start to end station with its value, plus the route from a .geojson file
Shows
The network with each station’s values on the map

Control room tour

Data
Assets across several regions
Settings
One saved view per region, Auto View Cycling with Start on Load
Shows
A wall screen that moves from region to region by itself

Related symbols: Asset Filter+ to filter the assets shown on the map, Asset Comparison Table+ for the same assets in a table, Asset Treemap+ for the AF hierarchy as tiles, and Asset Select+ to switch the asset context from a list.

Map+ FAQ

Questions we are asked most often. Read the Map+ documentation or ask a technical question.

How does Map+ know where each asset is?

From AF. Give the asset’s element template two numeric attributes for latitude and longitude and set their Location Latitude and Location Longitude traits. Map+ reads them for every asset on the map, whether you dragged the assets in or found them with Search Criteria.

Which map providers can we use, and what does that mean for network access and data?

OpenStreetMap, OpenTopoMap, Esri ArcGIS with several styles, and Mapbox with your own access token. Each viewer’s browser loads the map tiles directly from the provider, so it needs internet access to that provider; there is no setting for your own or an intranet tile server. The tile requests carry only the map area being viewed, not PI values or asset names. Availability and usage terms depend on the provider.

Can Map+ show hundreds of assets without clutter?

Yes. Clustering combines nearby markers into one with the Mean, Minimum, Maximum, Sum or Count of their values, and the individual assets appear as you zoom in. Saved views and view buttons take users straight to a region, and data labels can start hidden and be shown with a button on the map.

Can a click on the map filter other symbols?

Yes. Set the asset selection action to Filter, and a click on a marker publishes that asset to other Vision Library+ symbols such as Asset Comparison Table+. Map+ also follows master filters from Asset Filter+ and linked filters from other symbols. Other click actions open a quick trend, an ad hoc chart, a display or a URL, or set the asset context.

What do we need to run it?

PI Vision 2021 or later with PI Web API, and PI AF Server 2018 SP2 or later, because Map+ works with AF assets and attributes. Viewers’ browsers need access to the chosen map provider.

How do we get Map+?

Map+ is part of Vision Library+, together with the other Vision Library+ symbols. Request a trial to test it in your own PI Vision environment.

Try Map+ in your PI Vision

Map+ is included in Vision Library+, the PI Vision custom symbol library from Software Athlete. Test it on your own displays and data.

Request a trialBook a live demo

Browse all Vision Library+ symbols · Map+ documentation