GetElevationProfileFromSurfaceAsync(IEnumerable<Polyline>) Method

In This Topic

Gets an elevation profile for the specified polylines. All Z values of the calculated polyline are populated from the Ground Surface Layer.

Syntax

C#
Visual Basic (Declaration)

public Task<ElevationProfileResult> GetElevationProfileFromSurfaceAsync( 
   IEnumerable<Polyline> polylines
)

Public Overloads Function GetElevationProfileFromSurfaceAsync( _
   ByVal polylines As IEnumerable(Of Polyline) _
) As Task(Of ElevationProfileResult)

Parameters

polylines: A set of polylines.

Return Value

An ElevationProfileResult. If successful, this contains the generated polyline.

Exceptions

Exception	Description
System.ArgumentNullException	polylines cannot be null.
System.ArgumentException	This Map does not have a visible Ground Surface Layer.

Remarks

If the surface has no data at a particular input geometry point, then the corresponding output geometry point Z will be set to the value specified in SurfaceZsMissingHandler.DefaultOutputZ.

Example

Get Elevation profile from the default ground surface

// find the elevation profile for a polyline / set of polylines
var result = await MapView.Active.Map.GetElevationProfileFromSurfaceAsync([lineGeom]);
if (result.Status == SurfaceZsResultStatus.Ok)
{
  var polylineZ = result.Polyline;

  // process the polylineZ
}

// find the elevation profile for a set of points
result = await MapView.Active.Map.GetElevationProfileFromSurfaceAsync(pts);
if (result.Status == SurfaceZsResultStatus.Ok)
{
  var polylineZ = result.Polyline;

  // process the polylineZ
}

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.4 or higher.

Reference

Map Class
Map Members
Overload List

Send feedback