Method GetTransformation
GetTransformation(SpatialReference, SpatialReference)
Gets the best usable (default) transformation to transform between the input and output spatial references, without taking into account an area of interest.
Declaration
public static DatumTransformation GetTransformation(SpatialReference inputSpatialReference, SpatialReference outputSpatialReference)
Parameters
Type | Name | Description |
---|---|---|
SpatialReference | inputSpatialReference | The SpatialReference to use as the input. |
SpatialReference | outputSpatialReference | The SpatialReference to use as the output. |
Returns
Type | Description |
---|---|
DatumTransformation |
A DatumTransformation instance that represents the best choice given the
parameters. Always returns a usable transformation where
IsMissingProjectionEngineFiles is Prior to version 100.9, this method returned a GeographicTransformation.
From version 100.9 onwards, if both |
Remarks
The default transformation is the one that is used when calling Project(Geometry, SpatialReference) without specifying a transformation.
See Also
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 200.5 |
.NET | 100.13 - 200.5 |
.NET Windows | 100.13 - 200.5 |
.NET Android | 200.0 - 200.5 |
.NET iOS | 200.0 - 200.5 |
.NET Framework | 100.2.1 - 200.5 |
Xamarin.Android | 100.2.1 - 100.15 |
Xamarin.iOS | 100.2.1 - 100.15 |
UWP | 100.2.1 - 200.5 |
GetTransformation(SpatialReference, SpatialReference, Envelope)
Gets the best usable transformation to transform between the input and output spatial references and takes into account the area of interest, if specified.
Declaration
public static DatumTransformation GetTransformation(SpatialReference inputSpatialReference, SpatialReference outputSpatialReference, Envelope areaOfInterest)
Parameters
Type | Name | Description |
---|---|---|
SpatialReference | inputSpatialReference | The SpatialReference to use as the input. |
SpatialReference | outputSpatialReference | The SpatialReference to use as the output. |
Envelope | areaOfInterest | The bounding box of coordinates to be transformed, or |
Returns
Type | Description |
---|---|
DatumTransformation |
A DatumTransformation instance that represents the best choice given the
parameters. Always returns a usable transformation where
IsMissingProjectionEngineFiles is Prior to version 100.9, this method returned a GeographicTransformation.
From version 100.9 onwards, if both |
Remarks
If areaOfInterest
is null
or IsEmpty, the returned
transformation does not take into account an area of interest, and the best choice for the entire
world extent is effectively assumed.
Otherwise, if areaOfInterest
does not intersect the area of interest use
inputSpatialReference
, this method returns null
.
If the SpatialReference of areaOfInterest
differs from
inputSpatialReference
, then areaOfInterest
is reprojected
to inputSpatialReference
.
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 200.5 |
.NET | 100.13 - 200.5 |
.NET Windows | 100.13 - 200.5 |
.NET Android | 200.0 - 200.5 |
.NET iOS | 200.0 - 200.5 |
.NET Framework | 100.2.1 - 200.5 |
Xamarin.Android | 100.2.1 - 100.15 |
Xamarin.iOS | 100.2.1 - 100.15 |
UWP | 100.2.1 - 200.5 |
GetTransformation(SpatialReference, SpatialReference, Envelope, Boolean)
Returns the best usable transformation used to transform between the input and output spatial references, taking into account the area of interest, if specified. Optionally disregards any vertical transformations.
Declaration
public static DatumTransformation GetTransformation(SpatialReference inputSpatialReference, SpatialReference outputSpatialReference, Envelope areaOfInterest, bool ignoreVertical)
Parameters
Type | Name | Description |
---|---|---|
SpatialReference | inputSpatialReference | The spatial reference to use as the input. |
SpatialReference | outputSpatialReference | The spatial reference to use as the output. |
Envelope | areaOfInterest | The bounding box of coordinates to be transformed, or |
System.Boolean | ignoreVertical |
|
Returns
Type | Description |
---|---|
DatumTransformation | A DatumTransformation instance that represents the best choice given the
parameters. Always returns a usable transformation where
IsMissingProjectionEngineFiles is |
Remarks
Use this method to determine whether or not any vertical coordinate systems set on the
spatial reference parameters should be accounted for in the returned transformation. This
method can be used to replicate the former (prior to version 100.9.0) behavior of the
GetTransformation(SpatialReference, SpatialReference) and
GetTransformation(SpatialReference, SpatialReference, Envelope) methods.
Calling this method with ignoreVertical
= false
is equivalent to
calling GetTransformation(SpatialReference, SpatialReference, Envelope).
Calling this method with ignoreVertical
true
is equivalent to
calling GetTransformation(SpatialReference, SpatialReference, Envelope)
in releases prior to 100.9.0.
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.10 - 200.5 |
.NET | 100.13 - 200.5 |
.NET Windows | 100.13 - 200.5 |
.NET Android | 200.0 - 200.5 |
.NET iOS | 200.0 - 200.5 |
.NET Framework | 100.10 - 200.5 |
Xamarin.Android | 100.10 - 100.15 |
Xamarin.iOS | 100.10 - 100.15 |
UWP | 100.10 - 200.5 |