SDK Reference

The Ptv.Components.Projections namespace contains the classes that are essential for projecting or transforming coordinates in GIS-like applications.

CoordinateTransformation is the main class for the transformations, offering a set of methods for transforming coordinates specified either as System.Windows.Point, Location or simply using doubles.

CoordinateTransformation uses CoordinateReferenceSystem to describe the source and the target of a transformation. The Registry provides well known coordinate reference systems and provides an access using CRS identifiers (e.g. EPSG:4326). See classes CoordinateReferenceSystem.Mapserver and CoordinateReferenceSystem.XServer, which provide an access for PTV legacy systems.

At its base, the coordinate transformation uses the PROJ.4 Cartographic Projections Library. The Registry included is initialized on startup with specific PTV coordinate reference systems as well as other well known systems taken from an internal EPSG database, defining the coordinate reference systems in the Proj4 well known text format. A good and short summary on EPSG and its codes is provided by Wikipedia (german article). A good source for any coordinate reference system that might be missing is www.spatialreference.org.

The Map namespace contains the classes to visualize your data in an interactive map.

The main type is the WpfMap, which can be added to a XAML user control. An alternative FormsMap can be used for easy WinForms integration. Both controls inherit from Map and implement IMap. The Map type can be used to build up a customized map control.

A map is built-up with different Ptv.XServer.Controls.Map.Layers. There are several types of layers. The main types are TiledLayer, which renders map content split-up in bitmap tiles, UntiledLayer, which renders a new image whenever the map viewport changes and ShapeLayer, which can be used to display dynamic vector data. The map control has a LayerCollection to add, remove and manipulate the order and visibility of layers.

The MapLocalizer types can be used to set a custom localization for the texts used by the map control. The MapStringId defines the string to be localized.

This namespace contains tool classes for support.

The GeoTransform class contains methods to transform from world to map and screen coordinates.

The WkbToGdi and WkbToWpf classes contain methods to convert an OGC well-known-binary byte array to GDI and WPF geometry types.

The LineReductionClipping class can be used to reduce the number of points for complex line string. This can be used to display large routes for the vector layer.

The TileBasedPointClustererT class can be used to implement a clustering mechanism for a large amount of map locations.

Extension methods for WPF types. The type PointExtensions adds spatial transformation methods to the Point type.