Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Collapse]Concepts
  [Expand]Application Solution Components
  [Expand]Business Model Design
  [Expand]Application Model
  [Expand]UI Construction
  [Expand]Extend Functionality
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]Localization
  [Expand]System Module
  [Collapse]Extra Modules
   [Expand]Audit Trail Module Overview
    Business Class Library Customization Module
    Chart Module
    Clone Object Module
   [Expand]Conditional Appearance Module Overview
   [Expand]Dashboards Module
    File Attachments Module Overview
    HTML Property Editor Module
   [Expand]Notifications Module
    KPI Module
   [Collapse]Maps Module
     Maps Module Overview
     Use Raster Maps
     Display Areas on a Vector Map
     Display Bubble Markers on a Vector Map
     Display Pie Markers on a Vector Map
   [Expand]Pivot Chart Module
    Pivot Grid Module
   [Expand]Reports V2 Module
   [Expand]Reports Module (Obsolete)
   [Expand]Scheduler Module
    Script Recorder Module
   [Expand]State Machine Module
   [Expand]TreeList Editors Module
   [Expand]Validation Module
    View Variants Module
   [Expand]Workflow Module
  [Expand]Debugging and Error Handling
  [Expand]Filtering
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Functional Testing
 [Expand]Deployment
 [Expand]Task-Based Help
 [Expand]Frequently Asked Questions
 [Expand]API Reference
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
[Expand]End-User Documentation

Maps Module Overview

The Maps Module allows you to display business objects on a map in ASP.NET and Mobile XAF applications.

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. By default, the Feature Center demo is installed in %PUBLIC%\Documents\DevExpress Demos 17.1\Components\eXpressApp Framework\FeatureCenter. The ASP.NET version of this demo is available online at http://demos.devexpress.com/XAF/FeatureCenter/.

Expanded DevExpress Widgets Used by the Maps Module

The Maps Module only provides the Mobile applications with raster maps.

Expanded 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.

Expanded Maps Module Components

The Maps Module comprises a single ASP.NET-specific MapsAspNetModule and Mobile-specific MapsMobileModule components that can be added to corresponding application projects in the Application Designer.

Note

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

Platform Editor Editor's Control Description
Web 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.
Web 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.
Web 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.
Mobile MobileMapsListEditor DevExpress.ExpressApp.Maps.Mobile.Map Used automatically in List Views for business objects supporting the IMapsMarker interface. Displays markers corresponding to List View objects on an interactive map using the dxMap widget.
Mobile MobileMapsPropertyEditor DevExpress.ExpressApp.Maps.Mobile.Map 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.

Expanded 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.

Expanded Mobile Maps Module Specificities

  • It is possible to set the current location using the built-in GetCurrentPosition Action.
  • To create a new marker, long tap on a map. The latitude and longitude are automatically set in the opened Detail View.
  • Refreshing a map does not occur automatically. Use the built-in RefreshMap Action to refresh a map after marker changes.
  • The Map List View allows you to filter markers by their titles using the built-in FullTextSearch Action.

How would you rate this topic?​​​​​​​