GeoBlazor Pro

dymaptic.GeoBlazor.Pro

dymaptic.GeoBlazor.Pro.Components.Layers

ElevationLayer Class

ElevationLayer is a tile layer used for rendering elevations in SceneViews.
ArcGIS Maps SDK for JavaScript

public class ElevationLayer : dymaptic.GeoBlazor.Core.Components.Layers.Layer,
dymaptic.GeoBlazor.Core.Interfaces.IArcGISCachedService,
dymaptic.GeoBlazor.Core.Interfaces.IMapComponent,
dymaptic.GeoBlazor.Core.Interfaces.IElevationLayer,
dymaptic.GeoBlazor.Core.Interfaces.IMeshUtilsSource,
dymaptic.GeoBlazor.Core.Interfaces.IOperationalLayer,
dymaptic.GeoBlazor.Core.Interfaces.IPortalLayer

Inheritance System.Object 🡒 Microsoft.AspNetCore.Components.ComponentBase 🡒 dymaptic.GeoBlazor.Core.Components.MapComponent 🡒 dymaptic.GeoBlazor.Core.Components.Layers.Layer 🡒 ElevationLayer

Implements dymaptic.GeoBlazor.Core.Interfaces.IArcGISCachedService, dymaptic.GeoBlazor.Core.Interfaces.IMapComponent, dymaptic.GeoBlazor.Core.Interfaces.IElevationLayer, dymaptic.GeoBlazor.Core.Interfaces.IMeshUtilsSource, dymaptic.GeoBlazor.Core.Interfaces.IOperationalLayer, dymaptic.GeoBlazor.Core.Interfaces.IPortalLayer

Constructors

ElevationLayer() Constructor

Parameterless constructor for use as a Razor Component.

public ElevationLayer();

ElevationLayer(string, string, Extent, Nullable, Nullable, Nullable, Nullable, PortalItem, TileInfo, string, string, TimeExtent, Nullable) Constructor

Constructor for use in C# code. Use named parameters (e.g., item1: value1, item2: value2) to set properties in any order.

public ElevationLayer(string? arcGISLayerId=null, string? copyright=null, dymaptic.GeoBlazor.Core.Components.Geometries.Extent? fullExtent=null, System.Nullable<bool> isBasemapReferenceLayer=null, System.Nullable<dymaptic.GeoBlazor.Core.Enums.ListMode> listMode=null, System.Nullable<double> opacity=null, System.Nullable<bool> persistenceEnabled=null, dymaptic.GeoBlazor.Core.Components.PortalItem? portalItem=null, dymaptic.GeoBlazor.Core.Components.TileInfo? tileInfo=null, string? title=null, string? url=null, dymaptic.GeoBlazor.Core.Components.TimeExtent? visibilityTimeExtent=null, System.Nullable<bool> visible=null);

Parameters

arcGISLayerId System.String

The unique ID assigned to the layer.
ArcGIS Maps SDK for JavaScript

copyright System.String

The copyright text as defined by the service.
ArcGIS Maps SDK for JavaScript

fullExtent dymaptic.GeoBlazor.Core.Components.Geometries.Extent

The full extent of the layer.
ArcGIS Maps SDK for JavaScript

isBasemapReferenceLayer System.Nullable<System.Boolean>

Indicates whether the layer is a basemap reference layer. Default value: false.

listMode System.Nullable<dymaptic.GeoBlazor.Core.Enums.ListMode>

Indicates how the layer should display in the LayerList widget.
default “show”
ArcGIS Maps SDK for JavaScript

opacity System.Nullable<System.Double>

The opacity of the layer.
default 1
ArcGIS Maps SDK for JavaScript

persistenceEnabled System.Nullable<System.Boolean>

Enable persistence of the layer in a WebMap or WebScene.
default true
ArcGIS Maps SDK for JavaScript

portalItem dymaptic.GeoBlazor.Core.Components.PortalItem

The portal item from which the layer is loaded.
ArcGIS Maps SDK for JavaScript

tileInfo dymaptic.GeoBlazor.Core.Components.TileInfo

Contains information about the tiling scheme for the layer.
ArcGIS Maps SDK for JavaScript

title System.String

The title of the layer used to identify it in places such as the LayerList widget.
ArcGIS Maps SDK for JavaScript

url System.String

URL pointing to the Elevation layer resource on an ArcGIS Image Server.
ArcGIS Maps SDK for JavaScript

visibilityTimeExtent dymaptic.GeoBlazor.Core.Components.TimeExtent

Specifies a fixed time extent during which a layer should be visible.
default null
ArcGIS Maps SDK for JavaScript

visible System.Nullable<System.Boolean>

Indicates if the layer is visible in the View.
default true
ArcGIS Maps SDK for JavaScript

Properties

ElevationLayer.Copyright Property

The copyright text as defined by the service.
ArcGIS Maps SDK for JavaScript

public string? Copyright { get; set; }

Implements Copyright

Property Value

System.String

ElevationLayer.PortalItem Property

The portal item from which the layer is loaded.
ArcGIS Maps SDK for JavaScript

public dymaptic.GeoBlazor.Core.Components.PortalItem? PortalItem { get; set; }

Implements PortalItem

Property Value

dymaptic.GeoBlazor.Core.Components.PortalItem

ElevationLayer.SourceJSON Property

The image service’s metadata JSON
exposed by the ArcGIS REST API.
ArcGIS Maps SDK for JavaScript

public string? SourceJSON { get; set; }

Property Value

System.String

ElevationLayer.SpatialReference Property

The spatial reference of the layer as defined by the service.
ArcGIS Maps SDK for JavaScript

public dymaptic.GeoBlazor.Core.Components.SpatialReference? SpatialReference { get; set; }

Implements SpatialReference

Property Value

dymaptic.GeoBlazor.Core.Components.SpatialReference

ElevationLayer.TileInfo Property

Contains information about the tiling scheme for the layer.
ArcGIS Maps SDK for JavaScript

public dymaptic.GeoBlazor.Core.Components.TileInfo? TileInfo { get; set; }

Implements TileInfo

Property Value

dymaptic.GeoBlazor.Core.Components.TileInfo

ElevationLayer.Type Property

Used internally to identify the sub type of Layer

public override dymaptic.GeoBlazor.Core.Enums.LayerType Type { get; }

Property Value

dymaptic.GeoBlazor.Core.Enums.LayerType

ElevationLayer.Url Property

URL pointing to the Elevation layer resource on an ArcGIS Image Server.
ArcGIS Maps SDK for JavaScript

public string? Url { get; set; }

Property Value

System.String

Methods

ElevationLayer.CreateElevationSampler(Extent, ElevationLayerCreateElevationSamplerOptions, CancellationToken) Method

Creates an elevation sampler for the given Extent by querying the service layer
for elevation data and caching it so values may be sampled quickly afterwards.
param options Additional query options. See the table below.
param options.noDataValue The value to use when there is no data available.
ArcGIS Maps SDK for JavaScript

public System.Threading.Tasks.Task<dymaptic.GeoBlazor.Pro.Components.ElevationSampler?> CreateElevationSampler(dymaptic.GeoBlazor.Core.Components.Geometries.Extent extent, dymaptic.GeoBlazor.Pro.Options.ElevationLayerCreateElevationSamplerOptions options, System.Threading.CancellationToken cancellationToken=default(System.Threading.CancellationToken));

Parameters

extent dymaptic.GeoBlazor.Core.Components.Geometries.Extent

The extent for which to create the sampler.

options ElevationLayerCreateElevationSamplerOptions

  • options.demResolution: Controls the horizontal resolution (cell size) in meters from which elevation data is sampled (defaults to auto). See ElevationLayer for more details.
  • options.signal: An AbortSignal to abort the request. If canceled, the promise will be rejected with an error named AbortError. See also AbortController.

cancellationToken System.Threading.CancellationToken

The CancellationToken to cancel an asynchronous operation.

Returns

System.Threading.Tasks.Task<ElevationSampler>

ElevationLayer.FetchTile(double, double, double, ElevationLayerFetchTileOptions, CancellationToken) Method

Requests a tile from the service and decodes the data into a linear
array of elevation values.
param row the tile row.
param options Optional settings for the tile request.
param options.signal An AbortSignal to abort the request. If canceled, the promise will be rejected with an error named AbortError. See also AbortController.
ArcGIS Maps SDK for JavaScript

public System.Threading.Tasks.Task<dymaptic.GeoBlazor.Pro.Model.ElevationTileData?> FetchTile(double level, double row, double column, dymaptic.GeoBlazor.Pro.Options.ElevationLayerFetchTileOptions options, System.Threading.CancellationToken cancellationToken=default(System.Threading.CancellationToken));

Parameters

level System.Double

the tile level.

row System.Double

the tile row.

column System.Double

the tile column.

options ElevationLayerFetchTileOptions

  • options.noDataValue: The value representing pixels in the tile that don’t contain an elevation value.

cancellationToken System.Threading.CancellationToken

The CancellationToken to cancel an asynchronous operation.

Returns

System.Threading.Tasks.Task<ElevationTileData>

ElevationLayer.GetCopyright() Method

Asynchronously retrieve the current value of the Copyright property.

public System.Threading.Tasks.Task<string?> GetCopyright();

Implements GetCopyright()

Returns

System.Threading.Tasks.Task<System.String>

ElevationLayer.GetPortalItem() Method

Asynchronously retrieve the current value of the PortalItem property.

public System.Threading.Tasks.Task<dymaptic.GeoBlazor.Core.Components.PortalItem?> GetPortalItem();

Implements GetPortalItem()

Returns

System.Threading.Tasks.Task<dymaptic.GeoBlazor.Core.Components.PortalItem>

ElevationLayer.GetSourceJSON() Method

Asynchronously retrieve the current value of the SourceJSON property.

public System.Threading.Tasks.Task<string?> GetSourceJSON();

Returns

System.Threading.Tasks.Task<System.String>

ElevationLayer.GetSpatialReference() Method

Asynchronously retrieve the current value of the SpatialReference property.

public System.Threading.Tasks.Task<dymaptic.GeoBlazor.Core.Components.SpatialReference?> GetSpatialReference();

Implements GetSpatialReference()

Returns

System.Threading.Tasks.Task<dymaptic.GeoBlazor.Core.Components.SpatialReference>

ElevationLayer.GetTileInfo() Method

Asynchronously retrieve the current value of the TileInfo property.

public System.Threading.Tasks.Task<dymaptic.GeoBlazor.Core.Components.TileInfo?> GetTileInfo();

Implements GetTileInfo()

Returns

System.Threading.Tasks.Task<dymaptic.GeoBlazor.Core.Components.TileInfo>

ElevationLayer.GetTileUrl(double, double, double) Method

This method returns a URL to a tile for a given level, row and column.
param row The requested tile’s row.
ArcGIS Maps SDK for JavaScript

public System.Threading.Tasks.Task<string?> GetTileUrl(double level, double row, double col);

Parameters

level System.Double

The requested tile’s level.

row System.Double

The requested tile’s row.

col System.Double

The requested tile’s column.

Returns

System.Threading.Tasks.Task<System.String>

ElevationLayer.GetUrl() Method

Asynchronously retrieve the current value of the Url property.

public System.Threading.Tasks.Task<string?> GetUrl();

Returns

System.Threading.Tasks.Task<System.String>

ElevationLayer.QueryElevation(Geometry, ElevationLayerQueryElevationOptions, CancellationToken) Method

Queries the service layer for elevation values for the given geometry.
param options Additional query options. See the table below.
param options.returnSampleInfo Indicates whether to return additional sample information for each coordinate.
param options.signal An AbortSignal to abort the request. If canceled, the promise will be rejected with an error named AbortError. See also AbortController.
ArcGIS Maps SDK for JavaScript

public System.Threading.Tasks.Task<dymaptic.GeoBlazor.Pro.Results.ElevationLayerElevationQueryResult?> QueryElevation(dymaptic.GeoBlazor.Core.Components.Geometries.Geometry geometry, dymaptic.GeoBlazor.Pro.Options.ElevationLayerQueryElevationOptions options, System.Threading.CancellationToken cancellationToken=default(System.Threading.CancellationToken));

Parameters

geometry dymaptic.GeoBlazor.Core.Components.Geometries.Geometry

The geometry to use for sampling elevation data.

options ElevationLayerQueryElevationOptions

  • options.demResolution: Controls the horizontal resolution (cell size) in meters from which elevation data is sampled (defaults to auto). See the table below for more details on the different settings.
    demResolution | Description
    ———————–|————-
    auto | Automatically chooses an appropriate resolution for each coordinate of the input geometry. The current implementation will try to use the finest available resolution given that the total required number of tile requests does not exceed a certain maximum amount (currently 20). Note that this may result in values being sampled from different resolutions.
    finest-contiguous | Sample elevation from the finest available resolution (cell size) across the entire geometry.
    {number} | Sample elevation from the resolution closest to the specified resolution (in meters).
  • options.noDataValue: The value to use when there is no data available.

cancellationToken System.Threading.CancellationToken

The CancellationToken to cancel an asynchronous operation.

Returns

System.Threading.Tasks.Task<ElevationLayerElevationQueryResult>

ElevationLayer.SetCopyright(string) Method

Asynchronously set the value of the Copyright property after render.

public System.Threading.Tasks.Task SetCopyright(string? value);

Parameters

value System.String

The value to set.

Implements SetCopyright(string)

Returns

System.Threading.Tasks.Task

ElevationLayer.SetPersistenceEnabled(Nullable) Method

Asynchronously set the value of the PersistenceEnabled property after render.

public System.Threading.Tasks.Task SetPersistenceEnabled(System.Nullable<bool> value);

Parameters

value System.Nullable<System.Boolean>

The value to set.

Implements SetPersistenceEnabled(Nullable<bool>)

Returns

System.Threading.Tasks.Task

ElevationLayer.SetPortalItem(PortalItem) Method

Asynchronously set the value of the PortalItem property after render.

public System.Threading.Tasks.Task SetPortalItem(dymaptic.GeoBlazor.Core.Components.PortalItem? value);

Parameters

value dymaptic.GeoBlazor.Core.Components.PortalItem

The value to set.

Implements SetPortalItem(PortalItem)

Returns

System.Threading.Tasks.Task

ElevationLayer.SetTileInfo(TileInfo) Method

Asynchronously set the value of the TileInfo property after render.

public System.Threading.Tasks.Task SetTileInfo(dymaptic.GeoBlazor.Core.Components.TileInfo? value);

Parameters

value dymaptic.GeoBlazor.Core.Components.TileInfo

The value to set.

Implements SetTileInfo(TileInfo)

Returns

System.Threading.Tasks.Task

ElevationLayer.SetUrl(string) Method

Asynchronously set the value of the Url property after render.

public System.Threading.Tasks.Task SetUrl(string? value);

Parameters

value System.String

The value to set.

Returns

System.Threading.Tasks.Task

ElevationLayer.ValidateRequiredGeneratedChildren() Method

Validates source-generated child components.

public override void ValidateRequiredGeneratedChildren();

Implements ValidateRequiredGeneratedChildren()