Returns a copy of the input geometry, populated with Z values from the current elevation information in the map. Only applies when the map is in the 3D DisplayMode.

Namespace:  ESRI.ArcGISExplorer.Mapping

Assembly:  ESRI.ArcGISExplorer (in ESRI.ArcGISExplorer.dll) Version: 2.0.0.1500 (2.0.0.1500)

Syntax

C#
public Geometry GetSurfaceElevationGeometry(
	Geometry geometry
)
Visual Basic (Declaration)
Public Function GetSurfaceElevationGeometry ( _
	geometry As Geometry _
) As Geometry

Parameters

geometry
Type: ESRI.ArcGISExplorer.Geometry..::.Geometry

A geometry to copy.

Return Value

A copy of geometry populated with Z values from the current elevation information in the map.

Remarks

One typical use of this method is to generate Z values for geometries returned from tracking methods.

This method will only return a geometry in 3D display mode, as the Z values are extracted from the elevation layer in a map or basemap in 3D display mode. If the display mode is 2D, an exception will be thrown.

Elevation layers reference either an ArcGIS Server Globe Service or a raster elevation layer, and have different levels of resolution. This method uses the highest resolution level possible, and therefore can take some time to retrieve information for geometries with large numbers of vertices.

Points, Multipoints, Envelopes, Polylines and Polygons can be passed to this method, Multipatches are not supported.

Version Information: This method is supported from version 2.0.0.1500.

Exceptions

ExceptionCondition
ESRI.ArcGISExplorer..::.ExplorerExceptionCan only get surface elevation when display mode is 3D.

See Also