Configure global MapApp properties

The global properties for the MapApp consist of two types of information:

• Source map definitions. You must define each map that you want to acquire from a map provider for use in any ViewApp that includes a MapControl. You can define one or more maps from any or all supported map providers. Each source map is either a base map or a map overlay. (Some providers support only base maps, while others support both base maps and overlays.) During runtime, a base map displays as the opaque background and one or more overlays can display on top of it, with degrees of transparency that you set for each one.

• Zoom layers and the graphics they contain: You create zoom layers; each layer defines a zoom range (for example, between 10% and 20%). You then add graphics representing your organization's assets (or any other desired graphics) to each zoom layer at specific geographical locations. You can either enter the location or base it on the values of specified attributes. A graphic assigned to a particular zoom layer is shown only when the map zoom level is within the range for that zoom layer. Zoom layers and the graphics they contain are independent of the source maps, so the same graphics can appear at runtime in ViewApps that use different source maps.

You must define these global properties before you can add MapControls to layout panes for use in ViewApps. However, you can go back and change or add to the global properties at any time. For more information about adding and configuring MapControls, see Configure a MapControl.

Note: If you change the MapApp global properties, you need to redeploy any existing ViewApps that use the MapApp to make them reflect those changes.

To configure MapApp global properties

1. Open the System Platform IDE and select the Visualization tab.

2. Locate the MapApp in the following folder in the Visualization tab.

   ...\_Default Content\4 Apps\OMI Apps

3. Open the MapApp to show the Map Settings dialog box.

4. Define source maps:

   1. Select the Sources tab.

   2. In the first empty Name field, enter the name to give this source map.

   3. In the Provider field, select the map provider.

      

      The Properties area updates to include fields applicable to this provider. Also, the Configuration field shows parameters for this provider. You cannot make changes directly in the Configuration field; it reflects the information you enter in the Properties fields.

   4. Assign values for this source map in the Properties area. For more information about the properties of each map provider, see Map Source Properties.

      The map provider properties listed in the Configuration field update to show the properties you selected from the Properties field.

   5. If the map provider requires a credential, select the proper credential in the Credential Name field.

      Note: If the map provider does not require user credentials, skip this step.

   6. Repeat steps b-e to define all of your source maps.

      Note: If you want to use different source maps from the same provider, you must define each one separately.

5. Create zoom layers. Zoom layers allow you to determine what graphics are shown on a map based at a given zoom level. For more information, see Zoom layers.

   A 0 percent zoom level means no zoom, which is a view of the entire planet. A100 percent zoom level is the maximum zoom supported, which shows a map view at the street level.

   7. Select the Zoom Layers tab.

   8. In the first empty Name field, enter the name to give this zoom layer.

   9. Enter the Minimum Zoom and Maximum Zoom percentages.

   10. Repeat steps b-c to create as many zoom layers as you need.

   11. Set one layer as the default zoom layer by selecting it, then right-clicking and selecting Set as default. When you add graphics to the zoom layers in the next step, they will be assigned to this layer unless you select a different zoom layer.

6. Add graphics to zoom layers at the desired locations.

   12. Select the Locations tab.

   13. On the Assets or Toolbox tab, navigate to the desired graphic and drag it to the Locations grid.

   14. In Layer, select a zoom layer for the graphic. The zoom layer determines when the graphic will appear at runtime. For more information, see Zoom layers

   15. To specify the latitude and longitude where the graphic will appear on a map, select the Properties tab.

       In the Latitude and Longitude fields, enter the coordinates where you want the graphic to appear. You can enter either static values or dynamic values with binding to a User-Defined Attribute (UDA).

       To use static coordinates, enter:

       • Latitude: +/- 0-90.0

       • Longitude: +/- 0-180.0

       To use dynamic coordinates, enter a reference to a UDA, in the format:

       Asset_Name.Reference_Name

       For example:

       Static Coordinate Values	Dynamic Coordinate Values

       The center bottom of the graphic will be placed at the specified location.

   16. Repeat steps b-d until you have added all desired graphics. You can add the same graphic to different zoom layers, and to multiple locations on a zoom layer.