Configuring the MapApp: overview

To view a map in WindowViewer you can perform the following steps:

Note that you may skip some of the steps based on your requirements.

1. Complete a set of preparatory tasks:

   • If you want to use UDT to show on MapApp perform this step. In a new InTouch application, create UDTs, instances, and members. Add the location attributes Longitude and Latitude and configure them. For more information see, MapApp topic.

   • Set up accounts with the supported map providers whose data you want to show in WindowViewer, and, using the map provider, define each map that you want to be able to use.

   • If you want to use a local map server that would require local authentication, perform this step.Create user credentials to control access to the data shown by specific map vendors. For more information on creating credentials, see Work with Credential Manager.

   • Create a set of graphics that will appear on your maps using Industrial Graphic Editor.

2. Configure global settings for the MapApp:

   • Define the maps sources. A source map definition includes a name for the map, the map provider, whether the map is a base map or an overlay, and additional configuration information, which varies depending on the map provider.You must define each source map that you will use in WindowViewer. When you configure the MapApp for use in a particular window, you select which source map(s) to include in that window.

     Create a set of named zoom layers. Each layer is a range between minimum and maximum zoom percentages.

   • Place the graphics representing your company's assets onto each zoom layer at their proper geographic locations. At runtime, each graphic will display only when the map zoom is set within the range for its zoom layer. You can assign any graphic to multiple zoom layers and to multiple locations on a zoom layer, if desired.

     For more information and instructions, see Map settings.

3. Create a graphic and open in Industrial Graphic Editor.

   • Add the Map_App widget using Embed Industrial Graphic option.

   • Edit the widget property for the Map_App widget. For more information, see Configure a MapApp in a graphic.

4. Create a Window in WindowMaker and embed the graphic that you have created by dragging and dropping.

5. Switch to WindowViewer.

   Note: "MapApp" refers to the InTouch MapApp that you can use to include a map in an InTouch WindowViewer. When you place the MapApp in a window for use in a WindowViewer, it creates a "MapControl". Configuring the MapApp is a global process that you need to perform only once, though you can add or change information at any time. Each time you add the MapApp to a window, it creates a new MapControl, which you must configure.