Map_App widget
- Last UpdatedJul 12, 2024
- 3 minute read
AVEVA OMI and InTouch HMI include a Map_App widget to show a map containing graphics within a running application. During run time, the map provides controls and touch support to enable users to pan to different areas of the map and zoom in or out to show more or less map detail. Graphics placed in a map typically represent business assets located within an area shown by the map. These graphics can include alarming to show the current state of processes at each business location.
Properties
For AVEVA OMI, you configure specific properties of the Map_App widget from the Layout or ViewApp editors. For InTouch HMI, you configure specific properties of the Map_App widget from the Industrial Graphic editor.
|
Property |
Description |
|---|---|
|
ConfigName |
Name of the Map_App widget global configuration file. |
|
InitialLatitude |
Latitude of the initial center point map position in decimal degrees. Valid latitude values are +/- 0-90. |
|
InitialLongitude |
Longitude of the initial center point map position in decimal degrees.Valid longitude values are +/- 0-180. |
|
InitialZoom |
Zoom level percentage of a map when initially displayed during run time. |
|
MinZoom |
The minimum zoom percentage in which the map can be zoomed out (0-100%) during run time. |
|
MaxZoom |
The maximum zoom percentage in which the map can be zoomed in (0-100%) during run time. |
|
MaxBoundsSouth |
Latitude of the southern map boundary in decimal degrees (+/- 0-90) to constrain the vertical panning movement of the screen viewport midpoint to the bottom boundary of a map. |
|
MaxBoundsWest |
Longitude of the western map boundary in decimal degrees (+/- 0-180) to constrain the horizontal panning movement of the screen viewport midpoint to the left boundary of a map. |
|
MaxBoundsNorth |
Latitude of the northern map boundary in decimal degrees (+/- 0-90) to constrain the vertical panning movement of the screen viewport midpoint to the top boundary of a map. |
|
MaxBoundsEast |
Longitude of the eastern map boundary in decimal degrees (+/- 0-180) to constrain the horizontal panning movement of the screen viewport midpoint to the right boundary of a map. |
|
Asset |
Name of an asset selected from a displayed map. |
|
CurrentLatitude |
Current latitude of a selected item shown on a map. |
|
CurrentLongitude |
Current longitude of a selected item shown on a map. |
|
CurrentZoom |
Current zoom level of a displayed map. |
|
FollowCurrentAsset |
Set this property to true to enable the MapApp widget to follow the currently selected asset (context) and automatically pan and zoom the map to display the asset’s location and associated graphic (the asset should be added into the location tab in map app editor page and asset level should be as "-1"). Centers the map to a selected asset when the map is opened. You can use the assets to navigate within a ViewApp. For instance, you can display all the states and show a marker for each one of them. Then, by selecting a state, from a map, you can set the focus of the ViewApp to a separate pane that shows details about the state. The map will zoom to the selected asset's zoom layer plus 1 percent. If no asset is selected or a selected asset is not located on a map, the map shows the initial zoom layer and map center point. If the Asset property is configured, set the FollowCurrentAsset property to false to enable the map to follow the asset configured to load map using the asset's location and associated graphic. |
|
Sources |
Map data sources configured in the app's map settings. (All) is the default value, which includes all map data sources specified for the Map app. Note: All must be placed within parentheses (All) as a Sources property value. If you want to restrict a Map app to show data from only some map sources, use a comma delimited string to specify multiple sources. OSM,Bing,TemperatureOverlay |
|
ZoomLayers |
Map zoom layers configured for the Map app. (All) is the default value, which includes all zoom layers specified for the Map app. Note: All must be placed within parentheses (All) as a ZoomLayers property value. If you want to restrict a Map app to show data from only some zoom layers, use a comma delimited string to specify the zoom layers by name. country,state,city |