mapsglmaps/com.xweather.mapsgl.sources/ImageTileSource

ImageTileSource

class ImageTileSource(val id: String, typeString: String, val authenticator: XweatherAuthenticator?) : TileSource<TileData>

ImageTileSource.kt

Adapted from IOS version

Author

by Jason Suto on 11/30/23.

Constructors

ImageTileSource

constructor(id: String, typeString: String, authenticator: XweatherAuthenticator?)

Types

object Companion

class MetadataSchema : SourceMetadataSchema

Properties

_shouldTriggerLoadCompleteEvent

var _shouldTriggerLoadCompleteEvent: Boolean

val animTileList: MutableList<String>

val authenticator: XweatherAuthenticator?

var bounds: LatLonBounds?

open var datasets: List<DatasetType>

eventDispatcher

open override val eventDispatcher: EventDispatcher

open override val id: String

Same id as the registered style source / descriptor.

open val isEncoded: Boolean

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.

open override var tileCache: TileCache<DataType>

open override var tileManager: TileRequestManager<TileData>

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 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

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

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

open 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 onLoadFailed()

fun onTileError(tile: TileType, error: Error)

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

prepareTileRequest

fun prepareTileRequest(request: URLRequest, timeString: 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

Called from TilePyramid.requestTiles(), This will eventually initiate the download of bitmaps.

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)