Project Method (IGeometryEngine)

In This Topic

Projects the given geometry to a new spatial reference. Same as GeometryEngine.ProjectEx(geometry, ProjectionTransformation.Create(geometry.SpatialReference, outputSpatialReference)); or, if both spatial references have vertical coordinate systems same as GeometryEngine.ProjectEx(geometry, ProjectionTransformation.CreateWithVertical(geometry.SpatialReference, outputSpatialReference));

Syntax

Visual Basic (Declaration)
C#

Function Project( _
   ByVal geometry As Geometry, _
   ByVal outputSpatialReference As SpatialReference _
) As Geometry

Geometry Project( 
   Geometry geometry,
   SpatialReference outputSpatialReference
)

Parameters

geometry: The geometry to be projected. If the input geometry is empty, then an empty geometry with the output spatial reference is returned.
outputSpatialReference: The spatial reference to which the geometry will be projected.

Return Value

The projected geometry.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null.
System.NotImplementedException	The method is not implemented for GeometryBag.
System.ArgumentNullException	geometry.SpatialReference or output spatial reference is null.
System.ArgumentException	geometry.SpatialReference or output spatial reference is unknown coordinate system.

Example

Project from WGS84 to WebMercator

{
  MapPoint pt = MapPointBuilderEx.CreateMapPoint(1.0, 3.0, SpatialReferences.WGS84);
  Geometry result = GeometryEngine.Instance.Project(pt, SpatialReferences.WebMercator);
  MapPoint projectedPt = result as MapPoint;
}

Project from WGS84

{
  // create the polygon
  List<MapPoint> pts =
  [
    MapPointBuilderEx.CreateMapPoint(1.0, 1.0, SpatialReferences.WGS84),
  MapPointBuilderEx.CreateMapPoint(1.0, 2.0, SpatialReferences.WGS84),
  MapPointBuilderEx.CreateMapPoint(2.0, 2.0, SpatialReferences.WGS84),
  MapPointBuilderEx.CreateMapPoint(2.0, 1.0, SpatialReferences.WGS84),
];

  polygon = PolygonBuilderEx.CreatePolygon(pts);
  // ensure it is simple
  bool isSimple = GeometryEngine.Instance.IsSimpleAsFeature(polygon);

  // create the spatial reference to project to
  SpatialReference northPole = SpatialReferenceBuilder.CreateSpatialReference(102018);   // north pole stereographic 

  // project
  Geometry geometry = GeometryEngine.Instance.Project(polygon, northPole);
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback