Create Method—ArcGIS Pro

Creates a projection transformation from two spatial references and an extent of interest. Automatically selects a geographic transformation for the projection.

Syntax

C#
Visual Basic (Declaration)

public static ProjectionTransformation Create( 
   SpatialReference inputSR,
   SpatialReference outputSR,
   Envelope extentOfInterest
)

Public Shared Function Create( _
   ByVal inputSR As SpatialReference, _
   ByVal outputSR As SpatialReference, _
   Optional ByVal extentOfInterest As Envelope _
) As ProjectionTransformation

Parameters

inputSR: The spatial reference to project from. Cannot be unknown coordinate system.
outputSR: The spatial reference to project to. Cannot be unknown coordinate system.
extentOfInterest: (Optional) The extent of the data that is being projected. Default is null. A null value or an empty envelope means the extent is the entire world.

Exceptions

Exception	Description
System.ArgumentException	The input or output spatial reference is unknown coordinate system.

Example

// methods need to be on the MCT
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  SpatialReference sr4267 = SpatialReferenceBuilder.CreateSpatialReference(4267);
  SpatialReference sr4326 = SpatialReferences.WGS84;
  SpatialReference sr3857 = SpatialReferences.WebMercator;

  // Create transformation from  4267 -> 3857
  ProjectionTransformation projTransFromSRs = ArcGIS.Core.Geometry.ProjectionTransformation.Create(sr4267, sr3857);

  // create an envelope
  Envelope env = EnvelopeBuilder.CreateEnvelope(new Coordinate2D(2, 2), new Coordinate2D(3, 3), sr4267);

  // Project with one geo transform 4267 -> 3857
  Envelope projectedEnvEx = GeometryEngine.Instance.ProjectEx(env, projTransFromSRs) as Envelope;

  // Create inverse transformation, 3857 -> 4267
  ProjectionTransformation projTransFromSRsInverse = ArcGIS.Core.Geometry.ProjectionTransformation.Create(sr3857, sr4267);
  // Project the projected envelope back using the inverse transformation
  Envelope projectedEnvBack = GeometryEngine.Instance.ProjectEx(projectedEnvEx, projTransFromSRsInverse) as Envelope;

  bool isEqual = env.IsEqual(projectedEnvBack);
});

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

ProjectionTransformation Class
ProjectionTransformation Members