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 If both inputSpatialReference and outputSpatialReference have a vertical coordinate system, this method returns a HorizontalVerticalTransformation instance. If either SpatialReference does not have a vertical coordinate system, a GeographicTransformation is returned. |
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.6 |
| .NET | 100.13 - 200.6 |
| .NET Windows | 100.13 - 200.6 |
| .NET Android | 200.0 - 200.6 |
| .NET iOS | 200.0 - 200.6 |
| .NET Framework | 100.2.1 - 200.6 |
| Xamarin.Android | 100.2.1 - 100.15 |
| Xamarin.iOS | 100.2.1 - 100.15 |
| UWP | 100.2.1 - 200.6 |
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.6 |
| .NET | 100.13 - 200.6 |
| .NET Windows | 100.13 - 200.6 |
| .NET Android | 200.0 - 200.6 |
| .NET iOS | 200.0 - 200.6 |
| .NET Framework | 100.2.1 - 200.6 |
| Xamarin.Android | 100.2.1 - 100.15 |
| Xamarin.iOS | 100.2.1 - 100.15 |
| UWP | 100.2.1 - 200.6 |
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. If you set ignoreVertical to false,
this is equivalent to calling
GetTransformation(SpatialReference, SpatialReference, Envelope).
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 use of 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.10 - 200.6 |
| .NET | 100.13 - 200.6 |
| .NET Windows | 100.13 - 200.6 |
| .NET Android | 200.0 - 200.6 |
| .NET iOS | 200.0 - 200.6 |
| .NET Framework | 100.10 - 200.6 |
| Xamarin.Android | 100.10 - 100.15 |
| Xamarin.iOS | 100.10 - 100.15 |
| UWP | 100.10 - 200.6 |