Configure the MapControl

You place a map control into a ViewApp by selecting it from the Toolbox tab and dragging and dropping it on a layout pane.

Note: You must configure your map data sources before placing a Map control on a layout pane. See Map Source Properties.

To configure Map app properties

1. Open the Layout Editor or ViewApp Editor.

2. Select the Toolbox tab and locate the Map app 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 graphic beneath the Toolbox list of graphics and apps.

4. Drag and drop the MapControl thumbnail on a pane of a layout.

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

   

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

7. After specifying values to all properties, save your changes to the Map app.

   The following table includes descriptions of Map app 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 Map app 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 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.
   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	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
   Style Sheet	Sets the Cascading Style Sheet (CSS) for the map webpage.