Skip To Content ArcGIS for Developers Sign In Dashboard

DatumTransformation QML Type

A class to convert between two coordinate systems. More...

Import Statement: import Esri.ArcGISRuntime 100.9
Since: Esri.ArcGISRuntime 100.2
Inherits:

Object

Inherited By:

GeographicTransformation and HorizontalVerticalTransformation

Properties

Methods

Detailed Description

Note: You cannot declare or create a component of this type in QML code.

This is the base class for classes used to transform coordinates between spatial references that have different datums. The inverse of the datum transformation, used to transform in the opposite direction, may be accessed using a member function.

A DatumTransformation has a name property intended to be suitable for display, such as when displaying a list of available transformations to an end user.

You can get a list of suitable transformations for a given input and output spatial reference using methods of the TransformationCatalog class. Some transformations require that certain Projection Engine data files be present on the local file system. The property DatumTransformation::missingProjectionEngineFiles indicates if any of the files are missing. The complete list of necessary files is available using the GeographicTransformationStep::projectionEngineFilenames property.

In order for any Projection Engine files to be found, the data location must be set first using the TransformationCatalog::projectionEngineDirectory property.

A DatumTransformation object is immutable.

Property Documentation

datumTransformationType : Enums.DatumTransformationType

Returns the type of this datum transformation (read-only).

See also Enums.DatumTransformationType.


inputSpatialReference : SpatialReference

Returns the input spatial reference of the DatumTransformation (read-only).

Returns the spatial reference of the coordinates to be projected.


Returns the datum transformation that is the inverse of this datum transformation (read-only).

Returns null if there is no inverse transformation.


missingProjectionEngineFiles : bool

Returns whether any files needed by the Projection Engine for this datum transformation are missing from the local file system (read-only).


name : string

Returns the name of the DatumTransformation (read-only).

For multi-step transformations, the name contains the concatenated names of each step's transformation, separated by plus signs (+). If the transformation is inverted, the name starts with a tilde (~).


outputSpatialReference : SpatialReference

Returns the output spatial reference of the DatumTransformation (read-only).

Returns the spatial reference of the destination coordinates.


Method Documentation

bool equals(transformation)

Compares two datum transformation for equality.

Returns whether this instance and the other datum transformation are equal.



Feedback on this topic?