LocationWindowCommonExample.kt

Go to the documentation of this file.

import kotlinx.coroutines.delay
import kotlinx.coroutines.runBlocking
 
import com.navigine.idl.kotlin.DebugFlag
import com.navigine.idl.kotlin.LocationWindow
 
/**
 * LocationWindowCommon usage example for Kotlin
 * Demonstrates specific methods: setSublocationId, screenPositionToGlobal, globalToScreenPosition,
 * selectMapFeature, deselectMapFeature, deselectAllMapFeatures, selectedMapFeatures,
 * zoomFactor, minZoomFactor, maxZoomFactor
 */
class LocationWindowCommonExample {
 
    private var locationWindow: LocationWindow? = null
    private var userLocationLayer: UserLocationLayer? = null
    private var routeLayer: RouteLayer? = null
    private var routeLayerListener: RouteLayerListener? = null
    private var routeViewListener: RouteViewListener? = null
 
    init {
        demonstrateLocationWindowCommonMethods()
    }
 
    /**
     * Demonstrate LocationWindowCommon methods
     */
    fun demonstrateLocationWindowCommonMethods() {
        println("=== LocationWindowCommon Methods ===")
 
        demonstrateSetSublocationId()
        demonstrateOperatingMode()
        demonstrateSublocationQueries()
        demonstrateSublocationChangeListener()
        demonstrateUserLocationLayer()
        demonstrateRouteLayer()
        demonstrateCoordinateConversion()
        demonstrateMapFeatureSelection()
        demonstrateApplyLayerFilter()
        demonstrateDebugFlags()
        demonstrateZoomProperties()
    }
 
    /**
     * Demonstrate debug overlay flags (static LocationWindow API).
     */
    fun demonstrateDebugFlags() {
        println("--- Debug flags ---")
 
        // [kotlin_DebugFlag_enum]
        val allFlags = listOf(
            DebugFlag.NONE,
            DebugFlag.INFOS,
            DebugFlag.STATS,
            DebugFlag.LABELS,
            DebugFlag.DRAW_ALL_LABELS,
            DebugFlag.SELECTION_BUFFER
        )
        println("Debug flag enum values: ${allFlags.size}")
        // [kotlin_DebugFlag_enum]
 
        // [kotlin_LocationWindow_setDebugFlag]
        LocationWindow.setDebugFlag(DebugFlag.INFOS, true)
        LocationWindow.setDebugFlag(DebugFlag.STATS, false)
        println("Updated debug flags on LocationWindow")
        // [kotlin_LocationWindow_setDebugFlag]
 
        // [kotlin_LocationWindow_getDebugFlag]
        val infosOn = LocationWindow.getDebugFlag(DebugFlag.INFOS)
        println("Debug flag INFOS enabled: $infosOn")
        // [kotlin_LocationWindow_getDebugFlag]
    }
 
 
    /**
     * Demonstrate operating mode (indoor / outdoor basemap).
     */
    fun demonstrateOperatingMode() {
        println("--- Operating Mode ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_OperatingMode_enum]
        val modes = listOf(
            OperatingMode.INDOOR_ONLY,
            OperatingMode.OUTDOOR,
            OperatingMode.OUTDOOR_INDOOR
        )
        println("Operating modes: ${modes.size}")
        // [kotlin_OperatingMode_enum]
 
        // [kotlin_LocationWindow_setOperatingMode]
        locationWindow!!.setOperatingMode(OperatingMode.OUTDOOR_INDOOR)
        println("Set operating mode to OUTDOOR_INDOOR")
        // [kotlin_LocationWindow_setOperatingMode]
 
        // [kotlin_LocationWindow_getOperatingMode]
        val currentMode = locationWindow!!.operatingMode
        println("Current operating mode: $currentMode")
        // [kotlin_LocationWindow_getOperatingMode]
 
        // [kotlin_MapTheme_enum]
        val themes = listOf(MapTheme.LIGHT, MapTheme.DARK)
        println("Map themes: ${themes.size}")
        // [kotlin_MapTheme_enum]
 
        // [kotlin_LocationWindow_setMapTheme]
        locationWindow!!.mapTheme = MapTheme.DARK
        println("Set map theme to DARK")
        // [kotlin_LocationWindow_setMapTheme]
 
        // [kotlin_LocationWindow_getMapTheme]
        val currentTheme = locationWindow!!.mapTheme
        println("Current map theme: $currentTheme")
        // [kotlin_LocationWindow_getMapTheme]
 
        // [kotlin_TileKind_enum]
        val kinds = listOf(TileKind.VECTOR, TileKind.RASTER)
        println("Tile kinds: ${kinds.size}")
        // [kotlin_TileKind_enum]
 
        // [kotlin_TileSchema_enum]
        val schemas = listOf(TileSchema.SHORTBREAD, TileSchema.OPEN_MAP_TILES, TileSchema.MAPBOX_STREETS)
        println("Tile schemas: ${schemas.size}")
        // [kotlin_TileSchema_enum]
 
        // [kotlin_HttpTileSource_record]
        val http = HttpTileSource(
            "https://api.maptiler.com/tiles/v3-openmaptiles/{z}/{x}/{y}.pbf",
            null,
            mapOf("key" to "YOUR_MAPTILER_KEY"))
        // [kotlin_HttpTileSource_record]
 
        // [kotlin_MbtilesTileSource_record]
        val offline = MbtilesTileSource("/path/to/map.mbtiles")
        // [kotlin_MbtilesTileSource_record]
 
        // [kotlin_TileProvider_record]
        val osmHttp = TileProvider(
            TileSchema.OPEN_MAP_TILES,
            http,
            null,
            0,
            14,
            null,
            TileKind.VECTOR)
        val mbtiles = TileProvider(
            TileSchema.SHORTBREAD,
            null,
            offline,
            0,
            14,
            null,
            TileKind.VECTOR)
        // [kotlin_TileProvider_record]
 
        // [kotlin_LocationWindow_setTileProvider]
        locationWindow!!.tileProvider = osmHttp
        locationWindow!!.tileProvider = null
        val imagery = TileProvider(
            TileSchema.SHORTBREAD,
            HttpTileSource(
                "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
                null,
                null),
            null,
            0,
            19,
            "© OpenStreetMap contributors",
            TileKind.RASTER)
        locationWindow!!.tileProvider = imagery
        // [kotlin_LocationWindow_setTileProvider]
 
        // [kotlin_AttributionAlignment_record]
        val alignment = AttributionAlignment(
            AttributionHorizontalAlignment.RIGHT,
            AttributionVerticalAlignment.BOTTOM)
        // [kotlin_AttributionAlignment_record]
 
        // [kotlin_LocationWindow_setAttributionAlignment]
        locationWindow!!.attributionAlignment = alignment
        // [kotlin_LocationWindow_setAttributionAlignment]
 
        // [kotlin_LocationWindow_getAttribution]
        val attribution = locationWindow!!.attribution
        println("Attribution: $attribution")
        // [kotlin_LocationWindow_getAttribution]
    }
 
    /**
     * Demonstrate setSublocationId method
     */
    fun demonstrateSetSublocationId() {
        println("--- setSublocationId Method ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_setSublocationId]
        // Set sublocation ID to switch between floors
        locationWindow!!.setSublocationId(1)
        println("Set sublocation ID to 1 (first floor)")
        // [kotlin_LocationWindow_setSublocationId]
 
        // [kotlin_LocationWindow_setSublocationId_2]
        // Set sublocation ID to another floor
        locationWindow!!.setSublocationId(2)
        println("Set sublocation ID to 2 (second floor)")
        // [kotlin_LocationWindow_setSublocationId_2]
 
        // [kotlin_LocationWindow_setSublocationId_3]
        // Set sublocation ID to ground floor
        locationWindow!!.setSublocationId(0)
        println("Set sublocation ID to 0 (ground floor)")
        // [kotlin_LocationWindow_setSublocationId_3]
 
        // Test with different sublocation IDs
        val sublocationIds = listOf(1, 2, 3, 0, 5)
        for (id in sublocationIds) {
            locationWindow!!.setSublocationId(id)
            println("Switched to sublocation ID: $id")
        }
    }
 
    /**
     * Demonstrate getters for sublocation and enclosing camera
     */
    fun demonstrateSublocationQueries() {
        println("--- getSublocationId & getEnclosingCamera ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_getSublocationId]
        val currentId = locationWindow!!.getSublocationId()
        if (currentId != null) {
            println("Current sublocation id: $currentId")
        } else {
            println("Current sublocation id is not set")
        }
        // [kotlin_LocationWindow_getSublocationId]
 
        // [kotlin_LocationWindow_getEnclosingCamera]
        val boundingBox = BoundingBox(GlobalPoint(55.75, 37.61), GlobalPoint(55.76, 37.63))
        val camera = locationWindow!!.getEnclosingCamera(boundingBox)
        println("Camera that fits bounding box: $camera")
        // [kotlin_LocationWindow_getEnclosingCamera]
 
        // [kotlin_LocationWindow_setFocusRect]
        val focus = ScreenRect(ScreenPoint(0.0, 0.0), ScreenPoint(1000.0, 1600.0))
        locationWindow!!.focusRect = focus
        // [kotlin_LocationWindow_setFocusRect]
 
        // [kotlin_LocationWindow_getEnclosingCameraWithFocus]
        val padded = locationWindow!!.getEnclosingCameraWithFocus(boundingBox, focus, null, null)
        println("Camera that fits bounding box in focus rect: $padded")
        // [kotlin_LocationWindow_getEnclosingCameraWithFocus]
    }
 
    /**
     * Demonstrate sublocation change listener usage
     */
    fun demonstrateSublocationChangeListener() {
        println("--- Sublocation Change Listener ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        val listener = DemoSublocationChangeListener()
 
        // [kotlin_LocationWindow_addSublocationChangeListener]
        locationWindow!!.addSublocationChangeListener(listener)
        println("Added sublocation change listener")
        // [kotlin_LocationWindow_addSublocationChangeListener]
 
        locationWindow!!.setSublocationId(1)
        locationWindow!!.setSublocationId(2)
 
        // [kotlin_LocationWindow_removeSublocationChangeListener]
        locationWindow!!.removeSublocationChangeListener(listener)
        println("Removed sublocation change listener")
        // [kotlin_LocationWindow_removeSublocationChangeListener]
    }
 
    /**
     * Demonstrate user location layer controls
     */
    fun demonstrateUserLocationLayer() {
        println("--- UserLocationLayer ---")
 
        if (userLocationLayer == null) {
            println("UserLocationLayer not available yet")
            return
        }
 
        // [kotlin_UserLocationLayer_setVisible]
        userLocationLayer!!.setVisible(true)
        println("User location layer set visible")
        // [kotlin_UserLocationLayer_setVisible]
 
        // [kotlin_UserLocationLayer_isVisible]
        val visible = userLocationLayer!!.isVisible
        println("User location layer is visible: $visible")
        // [kotlin_UserLocationLayer_isVisible]
 
        // [kotlin_UserLocationLayer_setAnchor]
        val anchor = ScreenPoint(100.0f, 200.0f)
        userLocationLayer!!.setAnchor(anchor)
        println("Set user location anchor to: (${anchor.x}, ${anchor.y})")
        // [kotlin_UserLocationLayer_setAnchor]
 
        // [kotlin_UserLocationLayer_anchorEnabled]
        val anchorEnabled = userLocationLayer!!.anchorEnabled
        println("Anchor enabled: $anchorEnabled")
        // [kotlin_UserLocationLayer_anchorEnabled]
 
        // [kotlin_UserLocationLayer_setHeadingModeActive]
        userLocationLayer!!.setHeadingModeActive(true)
        println("Heading-up mode enabled")
        // [kotlin_UserLocationLayer_setHeadingModeActive]
 
        // [kotlin_UserLocationLayer_headingModeActive]
        val headingModeActive = userLocationLayer!!.headingModeActive
        println("Heading-up mode active: $headingModeActive")
        // [kotlin_UserLocationLayer_headingModeActive]
 
        // [kotlin_UserLocationLayer_setFollowMode]
        userLocationLayer!!.setFollowMode(UserLocationFollowMode.HEADING)
        println("Follow mode set to heading")
        // [kotlin_UserLocationLayer_setFollowMode]
 
        // [kotlin_UserLocationLayer_followMode]
        val followMode = userLocationLayer!!.followMode
        println("Follow mode: $followMode")
        // [kotlin_UserLocationLayer_followMode]
 
        // [kotlin_UserLocationLayer_setArrowBitmap]
        userLocationLayer!!.setArrowBitmap(ImageProvider.fromFile("/path/to/arrow.png", true))
        userLocationLayer!!.setArrowBitmap(null)
        println("Custom arrow bitmap cleared")
        // [kotlin_UserLocationLayer_setArrowBitmap]
 
        // [kotlin_UserLocationLayer_setAccuracyColor]
        userLocationLayer!!.setAccuracyColor(0x4230AAD9)
        println("Accuracy circle color updated")
        // [kotlin_UserLocationLayer_setAccuracyColor]
 
        // [kotlin_UserLocationLayer_resetAnchor]
        userLocationLayer!!.resetAnchor()
        println("Anchor reset to default")
        // [kotlin_UserLocationLayer_resetAnchor]
    }
 
    /**
     * Demonstrate route layer controls
     */
    fun demonstrateRouteLayer() {
        println("--- RouteLayer ---")
 
        if (routeLayer == null) {
            println("RouteLayer not available yet")
            return
        }
 
        // [kotlin_RouteLayer_setVisible]
        routeLayer!!.setVisible(true)
        println("Route layer set visible")
        // [kotlin_RouteLayer_setVisible]
 
        // [kotlin_RouteLayer_isVisible]
        val visible = routeLayer!!.isVisible
        println("Route layer is visible: $visible")
        // [kotlin_RouteLayer_isVisible]
 
        // [kotlin_RouteLayer_setTraveledColor]
        routeLayer!!.setTraveledColor(0xB4787878.toInt())
        println("Traveled color updated")
        // [kotlin_RouteLayer_setTraveledColor]
 
        // [kotlin_RouteLayer_setRemainingColor]
        routeLayer!!.setRemainingColor(0xFF30AAD9.toInt())
        println("Remaining color updated")
        // [kotlin_RouteLayer_setRemainingColor]
 
        // [kotlin_RouteLayer_setWidth]
        routeLayer!!.setWidth(8.0f)
        println("Route width updated")
        // [kotlin_RouteLayer_setWidth]
 
        // [kotlin_RouteLayer_setRemainingStyle]
        routeLayer!!.setRemainingStyle(RouteRemainingStyle.DOTTED)
        println("Remaining style set to DOTTED")
        // [kotlin_RouteLayer_setRemainingStyle]
 
        // [kotlin_RouteLayer_remainingStyle]
        val remainingStyle = routeLayer!!.remainingStyle
        println("Remaining style: $remainingStyle")
        // [kotlin_RouteLayer_remainingStyle]
 
        // [kotlin_RouteLayer_setRemainingPointSize]
        routeLayer!!.setRemainingPointSize(8.0f, 8.0f)
        println("Remaining point size updated")
        // [kotlin_RouteLayer_setRemainingPointSize]
 
        // [kotlin_RouteLayer_setRemainingPlacement]
        routeLayer!!.setRemainingPlacement(Placement.SPACED)
        println("Remaining placement updated")
        // [kotlin_RouteLayer_setRemainingPlacement]
 
        // [kotlin_RouteLayer_setRemainingPlacementSpacing]
        routeLayer!!.setRemainingPlacementSpacing(8.0f)
        println("Remaining placement spacing updated")
        // [kotlin_RouteLayer_setRemainingPlacementSpacing]
 
        // [kotlin_RouteLayer_setRemainingPlacementMinRatio]
        routeLayer!!.setRemainingPlacementMinRatio(0.0f)
        println("Remaining placement min ratio updated")
        // [kotlin_RouteLayer_setRemainingPlacementMinRatio]
 
        // [kotlin_RouteLayer_setRemainingCollisionEnabled]
        routeLayer!!.setRemainingCollisionEnabled(false)
        println("Remaining collision disabled")
        // [kotlin_RouteLayer_setRemainingCollisionEnabled]
 
        // [kotlin_RouteLayer_setRemainingDashLength]
        routeLayer!!.setRemainingDashLength(0.5f)
        println("Remaining dash length updated")
        // [kotlin_RouteLayer_setRemainingDashLength]
 
        // [kotlin_RouteLayer_setRemainingGapLength]
        routeLayer!!.setRemainingGapLength(0.4f)
        println("Remaining gap length updated")
        // [kotlin_RouteLayer_setRemainingGapLength]
 
        val from = RouteEndpoint(
            GlobalPoint(55.751244, 37.618423),
            1) // null for outdoor point
        val to = RouteEndpoint(
            GlobalPoint(55.751700, 37.619000),
            2) // null for outdoor point
 
        // [kotlin_RouteLayer_setRoute]
        routeLayer!!.setRoute(from, to)
        println("Static route applied")
        // [kotlin_RouteLayer_setRoute]
 
        // [kotlin_RouteLayer_setTarget]
        routeLayer!!.setTarget(to)
        println("Guidance target applied")
        // [kotlin_RouteLayer_setTarget]
 
        // [kotlin_RouteLayer_routes]
        val routes = routeLayer!!.routes()
        println("Visible routes: ${routes.size}")
        // [kotlin_RouteLayer_routes]
 
        // [kotlin_RouteLayer_selectedRoute]
        val selectedRoute = routeLayer!!.selectedRoute()
        if (selectedRoute != null) {
            println("Selected route length: ${selectedRoute.length()}")
        }
        // [kotlin_RouteLayer_selectedRoute]
 
        // [kotlin_RouteLayer_selectRoute]
        routes.firstOrNull()?.let { routeLayer!!.selectRoute(it) }
        // [kotlin_RouteLayer_selectRoute]
 
        // [kotlin_RouteLayer_addRouteLayerListener]
        routeLayerListener = object : RouteLayerListener {
            override fun onRouteChanged(status: RouteLayerStatus, route: RouteView?) {
                println("Route status: $status")
            }
 
            override fun onRouteAdvanced(progress: RouteProgress) {
                println("Remaining distance: ${progress.remainingDistance}, time: ${progress.remainingTime}s")
            }
 
            override fun onRouteTargetReached() {
                println("Route target reached")
            }
        }
        routeLayer!!.addRouteLayerListener(routeLayerListener!!)
        // [kotlin_RouteLayer_addRouteLayerListener]
 
        // [kotlin_RouteLayer_addRouteViewListener]
        routeViewListener = object : RouteViewListener {
            override fun onRouteViewsChanged() {
                println("Route views changed")
            }
 
            override fun onSelectedRouteChanged(route: RouteView?) {
                println("Selected route changed")
            }
 
            override fun onRouteViewTap(route: RouteView) {
                routeLayer!!.selectRoute(route)
            }
        }
        routeLayer!!.addRouteViewListener(routeViewListener!!)
        // [kotlin_RouteLayer_addRouteViewListener]
 
        // [kotlin_RouteLayer_clear]
        routeLayer!!.clear()
        println("Route layer cleared")
        // [kotlin_RouteLayer_clear]
    }
 
    /**
     * Demonstrate coordinate conversion methods
     */
    fun demonstrateCoordinateConversion() {
        println("--- Coordinate Conversion Methods ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_screenPositionToGlobal]
        val screenPoint = ScreenPoint(100.0, 200.0)
        val globalPoint = locationWindow!!.screenPositionToGlobal(screenPoint)
        println("Screen position (${screenPoint.x}, ${screenPoint.y}) converted to WGS84: (${globalPoint.latitude}, ${globalPoint.longitude})")
        // [kotlin_LocationWindow_screenPositionToGlobal]
 
        // [kotlin_LocationWindow_getVisibleRegion]
        val visibleRegion = locationWindow!!.visibleRegion
        println("Viewport top-left: ${visibleRegion.topLeft}")
        // [kotlin_LocationWindow_getVisibleRegion]
 
        // [kotlin_LocationWindow_getFocusRegion]
        val focusRegion = locationWindow!!.focusRegion
        println("Focus-rect top-left: ${focusRegion.topLeft}")
        // [kotlin_LocationWindow_getFocusRegion]
 
        // [kotlin_LocationWindow_globalToScreenPosition]
        val globalPoint2 = GlobalPoint(55.7558, 37.6176)
        val screenPoint2 = locationWindow!!.globalToScreenPosition(globalPoint2, true)
        println("WGS84 (${globalPoint2.latitude}, ${globalPoint2.longitude}) converted to screen with clipping: (${screenPoint2.x}, ${screenPoint2.y})")
        // [kotlin_LocationWindow_globalToScreenPosition]
 
        // Test coordinate conversion with different values
        val testScreenPoints = listOf(
            ScreenPoint(0.0, 0.0),
            ScreenPoint(250.0, 250.0),
            ScreenPoint(1000.0, 600.0)
        )
 
        for ((index, screenPoint) in testScreenPoints.withIndex()) {
            val global = locationWindow!!.screenPositionToGlobal(screenPoint)
            val backToScreen = locationWindow!!.globalToScreenPosition(global, false)
            println("Test $index: Screen (${screenPoint.x}, ${screenPoint.y}) -> WGS84 (${global.latitude}, ${global.longitude}) -> Screen (${backToScreen.x}, ${backToScreen.y})")
        }
    }
 
    /**
     * Demonstrate map feature selection methods
     */
    fun demonstrateMapFeatureSelection() {
        println("--- Map Feature Selection Methods ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_selectMapFeature]
        // Select map feature by ID
        val featureId = "room_101"
        val selected = locationWindow!!.selectMapFeature(featureId)
        println("Selected map feature $featureId: $selected")
        // [kotlin_LocationWindow_selectMapFeature]
 
        // [kotlin_LocationWindow_selectMapFeature_2]
        // Select another map feature
        val featureId2 = "office_205"
        val selected2 = locationWindow!!.selectMapFeature(featureId2)
        println("Selected map feature $featureId2: $selected2")
        // [kotlin_LocationWindow_selectMapFeature_2]
 
        // [kotlin_LocationWindow_getSelectedMapFeatures]
        // Get list of selected map features
        val selectedFeatures = locationWindow!!.selectedMapFeatures
        println("Currently selected map features: ${selectedFeatures.size} features")
        for (feature in selectedFeatures) {
            println("  - $feature")
        }
        // [kotlin_LocationWindow_getSelectedMapFeatures]
 
        // [kotlin_LocationWindow_deselectMapFeature]
        // Deselect specific map feature
        val deselected = locationWindow!!.deselectMapFeature(featureId)
        println("Deselected map feature $featureId: $deselected")
        // [kotlin_LocationWindow_deselectMapFeature]
 
        // [kotlin_LocationWindow_deselectMapFeature_2]
        // Deselect another map feature
        val deselected2 = locationWindow!!.deselectMapFeature(featureId2)
        println("Deselected map feature $featureId2: $deselected2")
        // [kotlin_LocationWindow_deselectMapFeature_2]
 
        // [kotlin_LocationWindow_deselectAllMapFeatures]
        // Deselect all map features
        locationWindow!!.deselectAllMapFeatures()
        println("Deselected all map features")
        // [kotlin_LocationWindow_deselectAllMapFeatures]
 
        // [kotlin_LocationWindow_getSelectedMapFeatures_2]
        // Verify all features are deselected
        val remainingFeatures = locationWindow!!.selectedMapFeatures
        println("Remaining selected features after deselect all: ${remainingFeatures.size} features")
        // [kotlin_LocationWindow_getSelectedMapFeatures_2]
 
        // Test multiple feature selection and deselection
        val testFeatureIds = listOf("room_101", "office_205", "meeting_room_301", "cafe_401")
 
        // Select multiple features
        for (featureId in testFeatureIds) {
            val success = locationWindow!!.selectMapFeature(featureId)
            println("Selected feature $featureId: $success")
        }
 
        // Check selected features
        val allSelected = locationWindow!!.selectedMapFeatures
        println("All selected features: ${allSelected.size} features")
 
        // Deselect all at once
        locationWindow!!.deselectAllMapFeatures()
        println("Deselected all features at once")
    }
 
    /**
     * Demonstrate applyLayerFilter method
     */
    fun demonstrateApplyLayerFilter() {
        println("--- applyLayerFilter Method ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_MapFilterCondition_constructor]
        // Create filter condition: show only venues with category "Toilet" or "Cafe"
        val condition = MapFilterCondition("category", listOf("Toilet", "Cafe"))
        // [kotlin_MapFilterCondition_constructor]
 
        // [kotlin_LocationWindow_applyLayerFilter]
        // Apply filter to venues layer
        val conditions = listOf(MapFilterCondition("category", listOf("Toilet", "Cafe")))
        locationWindow!!.applyLayerFilter("venues", conditions)
        println("Applied layer filter: show venues with category Toilet or Cafe")
        // [kotlin_LocationWindow_applyLayerFilter]
 
        // Reset filter (show all venues)
        locationWindow!!.applyLayerFilter("venues", emptyList())
        println("Reset layer filter: show all venues")
    }
 
    /**
     * Demonstrate zoom properties
     */
    fun demonstrateZoomProperties() {
        println("--- Zoom Properties ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_getZoomFactor]
        // Get current zoom factor
        val currentZoom = locationWindow!!.zoomFactor
        println("Current zoom factor: $currentZoom")
        // [kotlin_LocationWindow_getZoomFactor]
 
        // [kotlin_LocationWindow_setZoomFactor]
        // Set zoom factor
        locationWindow!!.zoomFactor = 150.0
        println("Set zoom factor to 150.0")
        // [kotlin_LocationWindow_setZoomFactor]
 
        // [kotlin_LocationWindow_getMinZoomFactor]
        // Get minimum zoom factor
        val minZoomFactor = locationWindow!!.minZoomFactor
        println("Minimum zoom factor: $minZoomFactor")
        // [kotlin_LocationWindow_getMinZoomFactor]
 
        // [kotlin_LocationWindow_setMinZoomFactor]
        // Set minimum zoom factor
        locationWindow!!.minZoomFactor = 50.0
        println("Set minimum zoom factor to 50.0")
        // [kotlin_LocationWindow_setMinZoomFactor]
 
        // [kotlin_LocationWindow_getMaxZoomFactor]
        // Get maximum zoom factor
        val maxZoomFactor = locationWindow!!.maxZoomFactor
        println("Maximum zoom factor: $maxZoomFactor")
        // [kotlin_LocationWindow_getMaxZoomFactor]
 
        // [kotlin_LocationWindow_setMaxZoomFactor]
        // Set maximum zoom factor
        locationWindow!!.maxZoomFactor = 300.0
        println("Set maximum zoom factor to 300.0")
        // [kotlin_LocationWindow_setMaxZoomFactor]
 
        // Test zoom factor changes
        val testZoomFactors = listOf(100.0, 125.0, 150.0, 200.0, 250.0)
        for (zoom in testZoomFactors) {
            locationWindow!!.zoomFactor = zoom
            println("Changed zoom factor to: ${locationWindow!!.zoomFactor}")
        }
 
        // Test zoom limits
        println("Testing zoom limits...")
        locationWindow!!.zoomFactor = locationWindow!!.minZoomFactor
        println("Set to minimum zoom: ${locationWindow!!.zoomFactor}")
 
        locationWindow!!.zoomFactor = locationWindow!!.maxZoomFactor
        println("Set to maximum zoom: ${locationWindow!!.zoomFactor}")
 
        // Reset to default
        locationWindow!!.zoomFactor = 100.0
        println("Reset zoom factor to default: ${locationWindow!!.zoomFactor}")
    }
 
    /**
     * Main demonstration method
     */
    suspend fun runExample() {
        println("=== LocationWindowCommon Example ===")
 
        // Simulate LocationWindow initialization
        delay(500)
 
        // TODO: User will implement LocationWindow initialization here
        // locationWindow = getLocationWindow()
 
        // Run demonstrations
        demonstrateLocationWindowCommonMethods()
 
        println("=== Example completed ===")
    }
}
 
/**
 * Function to run the example
 */
fun main() = runBlocking {
    val example = LocationWindowCommonExample()
    example.runExample()
}
 
class DemoSublocationChangeListener : SublocationChangeListener {
    // [kotlin_SublocationChangeListener_onActiveSublocationChanged]
    override fun onActiveSublocationChanged(sublocationId: Int) {
        println("Active sublocation changed to: $sublocationId")
    }
    // [kotlin_SublocationChangeListener_onActiveSublocationChanged]
}