ArcGIS Pro 3.1 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / Map Class / GetZsFromSurfaceAsync Method / GetZsFromSurfaceAsync(Geometry,ElevationSurfaceLayer,SurfaceZsMissingHandler,CancellationToken) Method
the input geometry
identifies the surface to be used - if specified null, then the default Ground Surface will be used
provides options to handle missing Zs in the surface
provides a way to cancel the operation

In This Topic
    GetZsFromSurfaceAsync(Geometry,ElevationSurfaceLayer,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 an Elevation Surface identified by the given surface name.
    Syntax

    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
    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
    ExceptionDescription
    the input geometry is null
    this Map does not have a surface named surfaceName
    this Map does not have a default Ground Surface (when surfaceName is specified null)
    this Map does not have a CIM definition
    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.0 or higher.
    See Also