[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Collapse]Map Control
   [Expand]Getting Started
   [Collapse]Coordinate Systems
     Map Coordinate Systems
     Geographical Projections
     Provide Cartesian Data to a Geographical Map
   [Expand]Map Image Data
   [Expand]GIS Data
   [Expand]Vector Data
   [Expand]Visual Elements
   [Expand]End-User Interaction
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Provide Cartesian Data to a Geographical Map

This document describes how to load Cartesian coordinate data onto a geographical map. The document consists of the following sections.

Expanded Overview

The ShapefileDataAdapter allows loading both Cartesian and geographical map data. To specify which kind of data the adapter should load, customize the CoordinateSystemDataAdapterBase.SourceCoordinateSystem property.

This property is set to null by default and to load Cartesian data, set this property to CartesianSourceCoordinateSystem.

Expanded Load a Coordinate System Metadata from the *.PRJ File

If your data contains the *.PRJ file and this file is located in the same directory and has the same name as a shapefile, the coordinate system will be loaded automatically. Otherwise, if the paths or the names are different, call the ShapefileDataAdapter.LoadPrjFile method to load coordinate system metadata.

The following code demonstrates this situation.

The following image demonstrates the result of loading coordinate system information from a *.PRJ file.

Expanded Specify Coordinate System Manually

If your data does not contain a *.PRJ file, it is possible to customize the Cartesian coordinate system manually. To do this, create a CartesianSourceCoordinateSystem object, specify its CartesianSourceCoordinateSystem.MeasureUnit and SourceCoordinateSystem.CoordinateConverter properties. Then, assign the object to the CoordinateSystemDataAdapterBase.SourceCoordinateSystem property.

The following code demonstrates this.

The following image demonstrates the result.

Expanded See Also

Is this topic helpful?​​​​​​​