GetZsAsync(Geometry,SurfaceZsMissingHandler,CancellationToken) 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 layer.

Syntax

C#
Visual Basic (Declaration)

public Task<SurfaceZsResult> GetZsAsync( 
   Geometry geometry,
   SurfaceZsMissingHandler missingHandler,
   CancellationToken cancellationToken
)

Public Overloads Function GetZsAsync( _
   ByVal geometry As Geometry, _
   ByVal missingHandler As SurfaceZsMissingHandler, _
   ByVal cancellationToken As CancellationToken _
) As Task(Of SurfaceZsResult)

Parameters

geometry: the input geometry
missingHandler: Provides options to handle missing Zs
cancellationToken: Provides a way to cancel the operation

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.

Remarks

The missingHandler will be used to determine what to do if the layer 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 with the InputZ value.

Use CanGetZsAsync to determine if the layer can be used as an elevation source before calling this function.

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.4 or higher.

Reference

Layer Class
Layer Members
Overload List

Send feedback