WorldWind Kotlin/earth.worldwind.ogc.wfs/WfsTiledFeatureSource

WfsTiledFeatureSource

class WfsTiledFeatureSource(val serviceAddress: String, val typeName: String, val serviceMetadata: String? = null, val cqlFilter: String? = null, val maxFeaturesPerTile: Int? = null, val sortBy: String? = null, val pageSize: Int? = null, val clientConfig: HttpClientConfig<*>.() -> Unit = {}) : TiledFeatureSource

TiledFeatureSource that fetches WFS features per slippy-map tile — Strategy 2 (cache-through). Each fetchTile issues a GetFeature bounded by the tile's Sector (so the server returns only that tile's features, capped at maxFeaturesPerTile) and decodes the response via WfsFeatureDecoder. Wrap in earth.worldwind.layer.cache.CachedTiledFeatureSource for the GeoPackage-backed coverage cache; drive with earth.worldwind.layer.TiledFeatureLayer.

Unlike WfsBulkFeatureSource (one GetFeature for the whole layer) this never downloads more than one viewport's worth of tiles, so it suits layers too large to fetch whole (e.g. global OSM water polygons).

Constructors

constructor(serviceAddress: String, typeName: String, serviceMetadata: String? = null, cqlFilter: String? = null, maxFeaturesPerTile: Int? = null, sortBy: String? = null, pageSize: Int? = null, clientConfig: HttpClientConfig<*>.() -> Unit = {})

Types

Companion

object Companion

Properties

clientConfig

val clientConfig: HttpClientConfig<*>.() -> Unit

cqlFilter

val cqlFilter: String?

maxFeaturesPerTile

val maxFeaturesPerTile: Int?

Server-side COUNT/MAXFEATURES cap per tile request.

pageSize

val pageSize: Int?

When set, fetch a dense tile in stable pages of this size instead of one request (use with sortBy). Null = single request per tile.

serviceAddress

val serviceAddress: String

serviceMetadata

val serviceMetadata: String?

sortBy

val sortBy: String?

Sortable property (typically the feature id) enabling strictly-stable STARTINDEX paging when pageSize is set. Omit for a single unpaged request per tile (relies on the server's order).

typeName

val typeName: 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, sector: Sector): Flow<CachedFeatureRow>?

tryReadCachedTile

open suspend fun tryReadCachedTile(z: Int, x: Int, y: Int, sector: Sector): Flow<CachedFeatureRow>?

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. Empty flow is the negative-cache sentinel ("fetched, no features"); null is a true miss.