GetZsFromSurfaceAsync(Geometry,ElevationSurfaceLayer,SurfaceZsMissingHandler) Method

In This Topic

Obtains a geometry that is similar to the given input geometry, where some or all Z values are populated from the specified Elevation Surface Layer.

Syntax

C#
Visual Basic (Declaration)

public Task<SurfaceZsResult> GetZsFromSurfaceAsync( 
   Geometry geometry,
   ElevationSurfaceLayer surfaceLayer,
   SurfaceZsMissingHandler missingHandler
)

Public Overloads Function GetZsFromSurfaceAsync( _
   ByVal geometry As Geometry, _
   ByVal surfaceLayer As ElevationSurfaceLayer, _
   ByVal missingHandler As SurfaceZsMissingHandler _
) As Task(Of SurfaceZsResult)

Parameters

geometry: the input geometry
surfaceLayer: Identifies the surface to be used - if specified null, then the default Ground Surface will be used
missingHandler: provides options to handle missing Zs in the surface

Return Value

A result that contains a status , plus an output geometry only if the status is favorable

Exceptions

Exception	Description
System.ArgumentNullException	The input geometry is null.
System.ArgumentException	This Map does not have the specified surfaceLayer.
System.ArgumentException	This Map does not have a default Ground Surface (when surfaceLayer is null)
System.InvalidOperationException	This Map does not have a CIM definition.
System.InvalidOperationException	This Map does not have any surfaces.

Remarks

The missingHandler will be used to determine what to do if the surface has no data at a particular input geometry point. The corresponding output geometry point or vertex Z will be set to the value specified in the provided missingHandler.OutputZ property. The missingHandler.OnlyProcessMissingZs parameter can be used to overwrite all Z values or only those that are designated as missing based on a comparison the InputZ value.

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

Map Class
Map Members
Overload List

Send feedback