Maps Module Overview

  • 4 minutes to read

The Maps Module allows you to display business objects on a map in ASP.NET applications. In WinForms applications, integrate the Map control as described in the following topics: Using a Custom Control that is not Integrated by Default, How to display geospatial information in XAF Views using Google, Bing or OpenStreet maps.

NOTE

You can see the demonstration of the Maps Module in the ListEditors | Maps section of the Feature Center application that is shipped with XAF. The Feature Center demo is installed in %PUBLIC%\Documents\DevExpress Demos 20.2\Components.NET Core Desktop Libraries\eXpressApp Framework\FeatureCenter by default. The ASP.NET version of this demo is available online at http://demos.devexpress.com/XAF/FeatureCenter/.

DevExpress Widgets Used by the Maps Module

Business Object Types Compatible with the Maps Module

The business class library does not supply built-in business classes supported by the Maps Module. This module should be used with your custom business classes that provide location information (e.g., Address, Office, Store, etc.). Implement one of the following interfaces declared in the DevExpress.Persistent.Base namespace in your custom business class (XPO persistent object or EF entity) to use this class with the Maps Module.

  • IMapsMarker - declares properties of business objects that can be displayed as markers on a raster map.
  • IAreaInfo - declares properties of business objects that can be displayed as an area on a vector map.
  • IVectorMapsMarker - declares properties of business objects that can be displayed as a bubble marker on a vector map.
  • IVectorMapsPieMarker - declares properties of business objects that can be displayed as a pie marker on a vector map.

For examples on implementing these interfaces, see their descriptions.

Maps Module Components

The Maps Module comprises a single ASP.NET-specific MapsAspNetModule component that can be added to a corresponding application project in the Application Designer.

MapsModule_Toolbox

NOTE

The Maps Module ships with the following List and Property editors.

Editor Editor's Control Description
WebMapsListEditor MapViewer Used automatically in List Views for business objects supporting the IMapsMarker interface. Displays markers corresponding to List View's objects on an interactive map using the dxMap widget.
WebMapsPropertyEditor MapViewer Used automatically in Detail Views for reference properties of the IMapsMarker type. Displays a marker corresponding to the current property on an interactive map using the dxMap widget.
WebVectorMapsListEditor VectorMapViewer Used automatically in List Views for business objects supporting the IAreaInfo, IVectorMapsMarker or IVectorMapsPieMarker interface. Displays List View's objects as areas, bubble markers or pie markers on an interactive vector map using the dxVectorMap widget.

Application Model Extensions

The Maps Module allows you to access map widget settings in the Model Editor. It extends the Application Model structure with the following nodes.