GetElevationProfileFromSurfaceAsync(IEnumerable<MapPoint>) Method

In This Topic

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

Syntax

C#
Visual Basic (Declaration)

public Task<ElevationProfileResult> GetElevationProfileFromSurfaceAsync( 
   IEnumerable<MapPoint> points
)

Public Overloads Function GetElevationProfileFromSurfaceAsync( _
   ByVal points As IEnumerable(Of MapPoint) _
) As Task(Of ElevationProfileResult)

Parameters

points: A set of points.

Return Value

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

Exceptions

Exception	Description
System.ArgumentNullException	points 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