GeodeticDensifyByDeviation Method (GeometryEngine)

In This Topic

Creates geodetic segments connecting existing vertices and densifies the segments.

Syntax

C#
Visual Basic (Declaration)

public Geometry GeodeticDensifyByDeviation( 
   Geometry geometry,
   double maxDeviation,
   LinearUnit deviationUnit,
   GeodeticCurveType curveType
)

Public Function GeodeticDensifyByDeviation( _
   ByVal geometry As Geometry, _
   ByVal maxDeviation As Double, _
   ByVal deviationUnit As LinearUnit, _
   ByVal curveType As GeodeticCurveType _
) As Geometry

Parameters

geometry: The geometry to be densified. Cannot be null and its spatial reference cannot be null.
maxDeviation: The maximum deviation allowed from the true curve. If maxDeviation is less than or equal to zero, the value of 50 km is used.
deviationUnit: The linear unit of maxDeviation.
curveType: The type of curve that connects the vertices of the densified geometry.

Return Value

The densified geometry. If the input geometry is empty, then it is returned unchanged.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null or geometry's spatial reference is null.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.
ArcGIS.Core.Geometry.Exceptions.GeometryObjectException	The geometry is of an incorrect type. (i.e. a point or multipoint).
ArcGIS.Core.Geometry.Exceptions.ProjectionEngineException	Geometry does not have a spatial reference.
System.NotImplementedException	Spatial reference of geometryis an image coordinate system.

Example

GeodeticDensifyByDeviation - polyline

List<Coordinate2D> coords = new List<Coordinate2D>()
{
  new Coordinate2D(-80, 0),
  new Coordinate2D(-20, 60),
  new Coordinate2D(40, 20),
  new Coordinate2D(0, -20),
  new Coordinate2D(-80, 0)
};

SpatialReference sr = SpatialReferences.WGS84;

// create a polyline
Polyline polyline = PolylineBuilderEx.CreatePolyline(coords, sr);

// densify in km
Polyline geodesicPolyline = GeometryEngine.Instance.GeodeticDensifyByDeviation(polyline, 200, LinearUnit.Kilometers, GeodeticCurveType.Geodesic) as Polyline;
// densify in m
geodesicPolyline = GeometryEngine.Instance.GeodeticDensifyByDeviation(polyline, 200, LinearUnit.Meters, GeodeticCurveType.Geodesic) as Polyline;

// Change curve type to Loxodrome
Polyline loxodromePolyline = GeometryEngine.Instance.GeodeticDensifyByDeviation(polyline, 200, LinearUnit.Meters, GeodeticCurveType.Loxodrome) as Polyline;

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback