WorldWind Kotlin/earth.worldwind.ogc/WmsElevationTileSource

WmsElevationTileSource

class WmsElevationTileSource(val serviceAddress: String, val coverageName: String, val outputFormat: String, val tileMatrixSet: TileMatrixSet, val coordinateSystem: String = "EPSG:4326", val wmsVersion: String = "1.3.0", headers: Map<String, String> = emptyMap(), connectTimeoutMs: Long = 5.seconds.inWholeMilliseconds, requestTimeoutMs: Long = 30.seconds.inWholeMilliseconds, clientConfig: HttpClientConfig<*>.() -> Unit = {}) : HttpTileSource

HttpTileSource for OGC Web Map Service (WMS) elevation endpoints (WMS 1.3.0 GetMap with an elevation-format payload such as application/bil16). Parallels Wcs100ElevationTileSource: indexes TileMatrixSet.entries by z, uses top-down y, and emits raw bytes for the cache decorator to persist via earth.worldwind.layer.cache.TileStore.

The WMS image-tile equivalent is WmsTileSource, which is row-indexed by earth.worldwind.util.LevelSet; this class is the elevation counterpart, row-indexed by TileMatrixSet so it composes with earth.worldwind.globe.elevation.TileSourceElevationSourceFactory directly.

Constructors

constructor(serviceAddress: String, coverageName: String, outputFormat: String, tileMatrixSet: TileMatrixSet, coordinateSystem: String = "EPSG:4326", wmsVersion: String = "1.3.0", headers: Map<String, String> = emptyMap(), connectTimeoutMs: Long = 5.seconds.inWholeMilliseconds, requestTimeoutMs: Long = 30.seconds.inWholeMilliseconds, clientConfig: HttpClientConfig<*>.() -> Unit = {})

Types

Companion

object Companion

Properties

coordinateSystem

val coordinateSystem: String

coverageName

val coverageName: String

headers

val headers: Map<String, String>

outputFormat

val outputFormat: String

serviceAddress

val serviceAddress: String

tileMatrixSet

val tileMatrixSet: TileMatrixSet

wmsVersion

val wmsVersion: String

Functions

open override fun close()

Release any resources held by the source (HTTP client, etc.). Idempotent default no-op.

fetchTile

open suspend override fun fetchTile(z: Int, x: Int, y: Int, previousEtag: String? = null, previousLastModified: String? = null): TileBlob?

launchBulkRetrieval

fun TileSource.launchBulkRetrieval(levelSet: LevelSet, sector: Sector, resolution: ClosedRange<Angle>, scope: CoroutineScope = GlobalScope, maxRetries: Int = 3, retryTimeoutShort: Duration = 5.seconds, retryTimeoutLong: Duration = 15.seconds, onProgress: (downloaded: Long, skipped: Long, total: Long) -> Unit? = null): Job

Download every tile that intersects sector across every level whose resolution falls in resolution — typically used by "save a region for offline use" flows. Returns the launched Job so the caller can cancel mid-download.

tryReadCachedTile

open suspend fun tryReadCachedTile(z: Int, x: Int, y: Int): TileBlob?

Cache-only fast-path read for (z, x, y). Default returns null — a plain network source has no cache to consult. Cache-backed sources override to read their store without going through the network-fetch concurrency budget.