Configure a MapControl

You place a MapControl into a ViewApp by selecting it from the Toolbox tab and dragging it to a layout pane.

Note: You must configure MapApp global settings before you can use a MapControl in a layout pane. See Map source properties.

To configure MapControl properties

1. Open the Layout Editor or ViewApp Editor.

2. Select the Toolbox tab and locate the MapApp in the list of controls and graphics.

   ...\Default Content\4. Apps\AVEVA OMI Apps\MapApp

3. Select MapApp from the list of AVEVA OMI apps to show the MapControl thumbnail at the bottom of the Toolbox pane.

4. Drag and drop the MapControl thumbnail to a layout pane.

5. Select the MapControl thumbnail within the pane and select the Properties grid to show the MapControl's properties.

   

6. Assign a value to each MapControl property. The following table describes each property.

7. After specifying values for all properties, save your changes.

   The following table contains descriptions of MapControl properties.You can reset any property to its default value by selecting the arrow before the entry field and selecting Reset.

   Property	Description
   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.
   LinkCurrentAsset	Like all AVEVA OMI Apps, the MapApp can follow the currently selected asset (context) and will automatically pan and zoom the map to display the asset’s location and associated graphic. If you select LinkCurrentAsset, map navigation shows the following zoom and location behaviors when an asset is selected: 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.
   MinZoom	The minimum zoom percentage to which the map can be zoomed out (0-100%) during run time.
   MaxZoom	The maximum zoom percentage to 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.
   MaxBoundsSouthDirection	Cardinal direction of the south boundary value (S/N).
   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.
   MaxBoundsWestDirection	Cardinal direction of the west boundary value (E/W).
   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.
   MaxBoundsNorthDirection	Cardinal direction of the north boundary value (S/N).
   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.
   MaxBoundsEastDirection	Cardinal direction of the east boundary value (E/W).
   Sources	Source maps configured in the MapApp settings. The default is (All). To show only some source maps, specify the source maps by name, separated by commas. For example: OSM,Bing,TemperatureOverlay Note: To set the value to All, you must include the parentheses: (All)
   ZoomLayers	Map zoom layers configured for the Map app. (All) is the default value, MapApp zoom layers to show symbols from. The default is (All). To show symbols from only some zoom layers, specify the zoom layers by name, separated by commas. For example: country,state,city Note: To set the value to All, you must include the parentheses: (All)
   Style Sheet	Sets the Cascading Style Sheet (CSS) for the map webpage.