Map settings

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 WindowViewer. 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 under Zoom Layers tab; 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 under Locations tab. 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 WindowViewer that use different source maps.

You can define these global properties before you add MapControls to the windows for use in WindowViewer or you can choose to go with the default options provided. 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 MapApp in a graphic.

Note: If you change the MapApp global properties, you need to reopen the WindowViewer that use the MapApp to make them reflect those changes.

Configure MapApp global properties

1. Open WindowMaker go to Industrial Graphics > Widgets and double-click Map_App to show the Map Settings dialog box.

2. 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. At the bottom of the Industrial Graphics pane, select the Properties tab to open Properties of the selected map provider. Assign values for the selected source map in the Properties area. For more information about the properties of each map provider, see Map provider 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 CredentialName field.

      Note: This step is only required when using a local map server that requires authentication. 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.

3. 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 selecting Set 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.

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

   12. Select the Locations tab.

   13. On the Industrial Graphics tab, navigate to the desired graphic and drag it to the Locations grid.

       Note: This only works if there is already a UDT instance available to associate with a graphic.

   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. Repeat steps b-c 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. Locations tab lists UDT instances and that can also be associated to a graphic.