mapsglmaps/com.xweather.mapsgl.sources/EncodedTileSource

EncodedTileSource

open class EncodedTileSource(val id: String, var authenticator: XweatherAuthenticator? = null) : TileSource<DataType>

EncodedTileSource.kt

Adapted from IOS version

Author

Suto on 01/08/23.

Inheritors

XweatherEncodedTileSource

Constructors

EncodedTileSource

constructor(id: String, authenticator: XweatherAuthenticator? = null)

Types

object Companion

class MetadataSchema : SourceMetadataSchema

Properties

_shouldTriggerLoadCompleteEvent

var _shouldTriggerLoadCompleteEvent: Boolean

val animTileList: MutableList<String>

open var authenticator: XweatherAuthenticator?

var bounds: LatLonBounds?

open override var datasets: List<DatasetType>

eventDispatcher

open override val eventDispatcher: EventDispatcher

open override val id: String

Same id as the registered style source / descriptor.

open override val isEncoded: Boolean = true

var isLoading: Boolean

open override var isReady: Boolean

true when metadata (and any bootstrap work) is available so layers can request tiles safely.

val TileSource<DataType>.isReady: Boolean

open override val kind: DataSourceKind

High-level source family (raster, encoded, vector, …).

var maxZoom: Float

val TileSource<DataType>.maxZoom: Float

lateinit var metadata: SourceMetadata<MetadataType>

var metaDataNeeded: Int

var metadataURL: String?

var minZoom: Float

val TileSource<DataType>.minZoom: Float

val TileSource<DataType>.needsMetadata: Boolean

ownerMapSessionId

var ownerMapSessionId: Long

com.xweather.mapsgl.map.MapController.mapSessionId that owns in-flight / ready tile bookkeeping.

val requests: <Error class: unknown class>

shouldTriggerLoadCompleteEvent

val shouldTriggerLoadCompleteEvent: Boolean = false

open override val tileCache: TileCache<DataType>

open override var tileManager: TileRequestManager<DataType>

val TileSource<DataType>.tiles: TileCache<DataType>

var tileSize: TileSize

val TileSource<DataType>.tileSize: TileSize

var tileURL: String?

open override var timeRange: ClosedRange<Date>?

Optional interval filter for time-series products; drives tile requests with timeline state.

val type: String

val DataSource.type: DataSourceKind

Alias for DataSource.kind (matches JS naming type).

Functions

open override fun addConsumer(consumer: DataSourceConsumer)

Register a layer that should receive updates when this source loads or changes.

addToAnimationQueue

fun addToAnimationQueue(inputString: String)

adjustDateBySeconds

fun adjustDateBySeconds(dateString: String, offsetSeconds: Long): String?

Used by prepareTileRequest() to increment or decremnet the time and reformate it for sources with time offets

open fun contains(coord: TileCoord): Boolean

fun <DataType : TileData> TileSource<DataType>.contains(coord: TileCoord): Boolean

fun dataRange(channel: SampleChannel): ClosedRange<Double>

Returns the data range for the specified channel.

open suspend fun fetchMetadata(startDate: Date?, endDate: Date?): Result<Unit>

Returns the metadata for the source, which can be loaded from a remote source.

fun getDataRange(band: ColorBand): ClosedRange<Double>

fun getDataRange(band: Int): ClosedRange<Double>

fun getMetadata(band: ColorBand): DatasetType?

fun getMetadata(band: Int): DatasetType?

open override fun getMetadataURL(): URL?

open fun getTileData(coord: TileCoord): Any?

fun <DataType : TileData> TileSource<DataType>.init(id: String, authenticator: Authenticator<MediaSession.Token>?)

intervalToIsoPathTime

fun intervalToIsoPathTime(intervalTime: String): String

Plain ISO-8601 for URL path {time} segments (encoded tile GET). Cache keys and POST validTimes still use bracketed ["…"] strings.

intervalToURLTime

fun intervalToURLTime(intervalTime: String): String

convert from \"2025-04-22T03:49:31Z\" to 20250422030000

fun makeTileURL(coord: TileCoord, variables: Map<String, Any>?): URL

fun metadata(forChannel: SampleChannel): EncodedDataset?

Returns the metadata for the specified channel, if available.

fun onLoadFailed()

fun onTileError(tile: TileType, error: Error)

suspend fun parseTile(tile: TileType, data: ByteArray, headers: <Error class: unknown class><Any, Any>?): Bitmap

prepareTileRequest

open fun prepareTileRequest(request: URLRequest, timeString: String?)

fun prepareTileRequest(request: URLRequest, timeString: String?, intervals: List<String>?)

inline fun <EventType : Event> EventSource.publisher(eventType: Class<EventType>): Flow<EventType>

open override fun removeConsumer(layerId: String)

Unregister a layer previously added with addConsumer.

removeFromAnimationQueue

fun removeFromAnimationQueue(inputString: String)

open suspend override fun requestTiles(coord: TileCoord, options: TileRequestOptions, currentDate: String, fromAnimation: Boolean, intervals: List<String>?, trackDownloadProgress: Boolean): Any

shouldRequestTile

fun shouldRequestTile(tile: TileType, reload: Boolean): Boolean

shouldRequestTile

fun <DataType : TileData> TileSource<DataType>.shouldRequestTile(tile: TileType, reload: Boolean): Boolean

inline suspend fun <EventType : Event> EventSource.subscribe(eventType: Class<EventType>, crossinline handler: (EventType) -> Unit)

fun <EventType : Event> EventSource.trigger(event: EventType)