Configuring the MapApp: overview

To include a map in an OMI ViewApp you must do the following:

1. Complete a set of preparatory tasks:

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

   • Create user credentials to control access to the data shown by specific map vendors.

   • Optionally, configure a local map server to save data from your map vendors.

   • Create a set of graphics that will appear on your maps.

     For more information and instructions, see Before configuring the MapApp.

2. Configure global settings for the MapApp:

   • Define the source maps. 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 any ViewApp. When you configure the MapApp for use in a particular layout pane, you select which source map(s) to include in that pane.

     The provider data can be hosted on either a local or remote map server. Most providers will require a web server, but other providers offer map tiles that can be stored locally in a shared folder.

   • 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 Configure global MapApp properties.

3. Add a MapControl to a layout pane and configure the properties for this particular map. These properties include which source map(s) to use, the initial location and zoom level, and more.

   For more information and instructions, see Configure a MapControl

   Note: "MapApp" refers to the OMI App that you can use to include a map in an OMI ViewApp. When you place the MapApp in a layout pane for use in a ViewApp, 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 layout pane, it creates a new MapControl, which you must configure.