Method GetTransformationsBySuitability
GetTransformationsBySuitability(SpatialReference, SpatialReference)
Gets a list representing the datum transformations suitable for projecting between spatial references without taking into account the area of interest.
Declaration
public static IReadOnlyList<DatumTransformation> GetTransformationsBySuitability(SpatialReference inputSpatialReference, SpatialReference outputSpatialReference)
Parameters
Type | Name | Description |
---|---|---|
Spatial |
inputSpatialReference | The Spatial |
Spatial |
outputSpatialReference | The Spatial |
Returns
Type | Description |
---|---|
System. |
A read-only list containing Datum
Prior to version 100.9, this method only considered geographic coordinate systems, and
the returned read-only list of datum transformation objects were of the subtype
Geographic
From version 100.9 onwards, if both
To replicate the former behavior, use the
Get |
Remarks
The list is ordered in descending order by suitability, with the most suitable being first in the list.
Some transformations require a supporting Projection Engine (PE) dataset to function correctly, and ArcGIS
Runtime must be able to locate these datasets. If the datasets cannot be located, the transformation is not
currently usable, and Istrue
. The list may include
transformations like this. To use such transformations, ensure
Projection
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 100.15 |
.NET 6.0 | 100.13 - 100.15 |
.NET 6.0 Windows | 100.13 - 100.15 |
.NET Framework | 100.2.1 - 100.15 |
.NET 5 | 100.10 - 100.12 |
.NET Core 3.1 | 100.7 - 100.12 |
Xamarin.Android | 100.2.1 - 100.15 |
Xamarin.iOS | 100.2.1 - 100.15 |
UWP | 100.2.1 - 100.15 |
GetTransformationsBySuitability(SpatialReference, SpatialReference, Envelope)
Gets a list representing the datum transformations suitable for projecting between spatial references and takes into account the area of interest.
Declaration
public static IReadOnlyList<DatumTransformation> GetTransformationsBySuitability(SpatialReference inputSpatialReference, SpatialReference outputSpatialReference, Envelope areaOfInterest)
Parameters
Type | Name | Description |
---|---|---|
Spatial |
inputSpatialReference | The Spatial |
Spatial |
outputSpatialReference | The Spatial |
Envelope | areaOfInterest | The bounding box of coordinates to be transformed, or |
Returns
Type | Description |
---|---|
System. |
A read-only list containing Datum
Prior to version 100.9, this method only considered geographic coordinate systems, and
the returned array of Datum
From version 100.9 onwards, if both
To replicate the former behavior, use the
Get |
Remarks
The list is ordered in descending order by suitability, with the most suitable being first in the list. The given area of interest can affect the number and order of transformations returned.
Some transformations require a supporting Projection Engine (PE) dataset to function correctly, and ArcGIS
Runtime must be able to locate these datasets. If the datasets cannot be located, the transformation is not
currently usable, and Istrue
. The list may include
transformations like this. To use such transformations, ensure
Projection
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 100.15 |
.NET 6.0 | 100.13 - 100.15 |
.NET 6.0 Windows | 100.13 - 100.15 |
.NET Framework | 100.2.1 - 100.15 |
.NET 5 | 100.10 - 100.12 |
.NET Core 3.1 | 100.7 - 100.12 |
Xamarin.Android | 100.2.1 - 100.15 |
Xamarin.iOS | 100.2.1 - 100.15 |
UWP | 100.2.1 - 100.15 |
GetTransformationsBySuitability(SpatialReference, SpatialReference, Envelope, Boolean)
Returns a collection of transformations suitable for projecting between the input and output spatial references, taking into account the area of interest, if specified. Optionally checks for suitable vertical transformations.
Declaration
public static IReadOnlyList<DatumTransformation> GetTransformationsBySuitability(SpatialReference inputSpatialReference, SpatialReference outputSpatialReference, Envelope areaOfInterest, bool ignoreVertical)
Parameters
Type | Name | Description |
---|---|---|
Spatial |
inputSpatialReference | The Spatial |
Spatial |
outputSpatialReference | The Spatial |
Envelope | areaOfInterest | The bounding box of coordinates to be transformed, or |
Boolean | ignoreVertical |
|
Returns
Type | Description |
---|---|
System. |
A collection of Datum |
Remarks
The collection is ordered in descending order by suitability, with the most suitable being first in the list. The given area of interest can affect the number and order of transformations returned. A geographic transformation is not needed when input and output spatial references have the same underlying geographic coordinate system, in which case an empty list is returned. A vertical transformation is not needed if both datums (for ellipsoidal heights) or vertical datums (for gravity-related heights) are the same. If neither type of transformation is needed, an empty collection is returned.
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 list of transformations. This method can be used to
replicate the former (prior to version 100.9.0) behavior of the
Get
Calling this method with ignoreVertical = false
is equivalent to calling
Get
Calling this method with ignoreVertical = true
is equivalent to
Get
Some transformations require a supporting Projection Engine (PE) dataset to function correctly, and ArcGIS
Runtime must be able to locate these datasets. If the datasets cannot be located, the transformation is not
currently usable, and Istrue
. The list may include
transformations like this. To use such transformations, ensure
Projection
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.10 - 100.15 |
.NET 6.0 | 100.13 - 100.15 |
.NET 6.0 Windows | 100.13 - 100.15 |
.NET Framework | 100.10 - 100.15 |
.NET 5 | 100.10 - 100.12 |
.NET Core 3.1 | 100.10 - 100.12 |
Xamarin.Android | 100.10 - 100.15 |
Xamarin.iOS | 100.10 - 100.15 |
UWP | 100.10 - 100.15 |