LocationWindowCommonExample.swift

Go to the documentation of this file.

import Foundation
import Dispatch
import UIKit
 
class DemoRouteLayerListener: NSObject, RouteLayerListener {
    func onRouteChanged(_ status: RouteLayerStatus, route: RouteView?) {
        print("Route status: \‍(status)")
    }
 
    func onRouteAdvanced(_ progress: RouteProgress) {
        print("Remaining distance: \‍(progress.remainingDistance), time: \‍(progress.remainingTime)s")
    }
 
    func onRouteTargetReached() {
        print("Route target reached")
    }
}
 
class DemoRouteViewListener: NSObject, RouteViewListener {
    private weak var routeLayer: RouteLayer?
 
    init(routeLayer: RouteLayer) {
        self.routeLayer = routeLayer
    }
 
    func onRouteViewsChanged() {
        print("Route views changed")
    }
 
    func onSelectedRouteChanged(_ route: RouteView?) {
        print("Selected route changed")
    }
 
    func onRouteViewTap(_ route: RouteView) {
        routeLayer?.selectRoute(route)
    }
}
 
/**
 * LocationWindowCommon usage example for Swift
 * Demonstrates specific methods: setSublocationId, screenPositionToGlobal, globalToScreenPosition,
 * selectMapFeature, deselectMapFeature, deselectAllMapFeatures, selectedMapFeatures,
 * zoomFactor, minZoomFactor, maxZoomFactor
 */
class LocationWindowCommonExample {
 
    private var locationWindow: LocationWindow?
    private var userLocationLayer: UserLocationLayer?
    private var routeLayer: RouteLayer?
    private var routeLayerListener: RouteLayerListener?
    private var routeViewListener: RouteViewListener?
 
    init() {
        demonstrateLocationWindowCommonMethods()
    }
 
    /**
     * Demonstrate LocationWindowCommon methods
     */
    func demonstrateLocationWindowCommonMethods() {
        print("=== LocationWindowCommon Methods ===")
 
        demonstrateSetSublocationId()
        demonstrateOperatingMode()
        demonstrateSublocationQueries()
        demonstrateSublocationChangeListener()
        demonstrateUserLocationLayer()
        demonstrateRouteLayer()
        demonstrateCoordinateConversion()
        demonstrateMapFeatureSelection()
        demonstrateApplyLayerFilter()
        demonstrateDebugFlags()
        demonstrateZoomProperties()
    }
 
    /**
     * Demonstrate debug overlay flags (static NCLocationWindow API).
     */
    func demonstrateDebugFlags() {
        print("--- Debug flags ---")
 
        // [swift_DebugFlag_enum]
        let allFlags: [NCDebugFlag] = [.none, .infos, .stats, .labels, .drawAllLabels, .selectionBuffer]
        print("Debug flag enum values: \‍(allFlags.count)")
        // [swift_DebugFlag_enum]
 
        // [swift_LocationWindow_setDebugFlag]
        NCLocationWindow.setDebugFlag(.infos, on: true)
        NCLocationWindow.setDebugFlag(.stats, on: false)
        print("Updated debug flags on LocationWindow")
        // [swift_LocationWindow_setDebugFlag]
 
        // [swift_LocationWindow_getDebugFlag]
        let infosOn = NCLocationWindow.getDebugFlag(.infos)
        print("Debug flag INFOS enabled: \‍(infosOn)")
        // [swift_LocationWindow_getDebugFlag]
    }
 
 
    /**
     * Demonstrate operating mode (indoor / outdoor basemap).
     */
    func demonstrateOperatingMode() {
        print("--- Operating Mode ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_OperatingMode_enum]
        let modes: [NCOperatingMode] = [.indoorOnly, .outdoor, .outdoorIndoor]
        print("Operating modes: \‍(modes.count)")
        // [swift_OperatingMode_enum]
 
        // [swift_LocationWindow_setOperatingMode]
        locationWindow.setOperatingMode(.outdoorIndoor)
        print("Set operating mode to outdoorIndoor")
        // [swift_LocationWindow_setOperatingMode]
 
        // [swift_LocationWindow_getOperatingMode]
        let currentMode = locationWindow.getOperatingMode()
        print("Current operating mode: \‍(currentMode)")
        // [swift_LocationWindow_getOperatingMode]
 
        // [swift_MapTheme_enum]
        let themes: [NCMapTheme] = [.light, .dark]
        print("Map themes: \‍(themes.count)")
        // [swift_MapTheme_enum]
 
        // [swift_LocationWindow_setMapTheme]
        locationWindow.setMapTheme(.dark)
        print("Set map theme to dark")
        // [swift_LocationWindow_setMapTheme]
 
        // [swift_LocationWindow_getMapTheme]
        let currentTheme = locationWindow.getMapTheme()
        print("Current map theme: \‍(currentTheme)")
        // [swift_LocationWindow_getMapTheme]
 
        // [swift_TileKind_enum]
        let kinds: [NCTileKind] = [.vector, .raster]
        print("Tile kinds: \‍(kinds.count)")
        // [swift_TileKind_enum]
 
        // [swift_TileSchema_enum]
        let schemas: [NCTileSchema] = [.shortbread, .openMapTiles, .mapboxStreets]
        print("Tile schemas: \‍(schemas.count)")
        // [swift_TileSchema_enum]
 
        // [swift_HttpTileSource_record]
        let http = NCHttpTileSource(
            urlTemplate: "https://api.maptiler.com/tiles/v3-openmaptiles/{z}/{x}/{y}.pbf",
            headers: nil,
            queryParameters: ["key": "YOUR_MAPTILER_KEY"])
        // [swift_HttpTileSource_record]
 
        // [swift_MbtilesTileSource_record]
        let offline = NCMbtilesTileSource(path: "/path/to/map.mbtiles")
        // [swift_MbtilesTileSource_record]
 
        // [swift_TileProvider_record]
        let osmHttp = NCTileProvider(
            schema: .openMapTiles,
            http: http,
            mbtiles: nil,
            minZoom: 0,
            maxZoom: 14,
            attribution: nil,
            kind: .vector)
        let mbtiles = NCTileProvider(
            schema: .shortbread,
            http: nil,
            mbtiles: offline,
            minZoom: 0,
            maxZoom: 14,
            attribution: nil,
            kind: .vector)
        // [swift_TileProvider_record]
 
        // [swift_LocationWindow_setTileProvider]
        locationWindow.setTileProvider(osmHttp)
        locationWindow.setTileProvider(nil)
        let imageryHttp = NCHttpTileSource(
            urlTemplate: "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
            headers: nil,
            queryParameters: nil)
        let imagery = NCTileProvider(
            schema: .shortbread,
            http: imageryHttp,
            mbtiles: nil,
            minZoom: 0,
            maxZoom: 19,
            attribution: "© OpenStreetMap contributors",
            kind: .raster)
        locationWindow.setTileProvider(imagery)
        // [swift_LocationWindow_setTileProvider]
 
        // [swift_AttributionAlignment_record]
        let alignment = NCAttributionAlignment(
            horizontalAlignment: .right,
            verticalAlignment: .bottom)
        // [swift_AttributionAlignment_record]
 
        // [swift_LocationWindow_setAttributionAlignment]
        locationWindow.setAttributionAlignment(alignment)
        // [swift_LocationWindow_setAttributionAlignment]
 
        // [swift_LocationWindow_getAttribution]
        let attribution = locationWindow.getAttribution()
        print("Attribution: \‍(attribution)")
        // [swift_LocationWindow_getAttribution]
    }
 
    /**
     * Demonstrate setSublocationId method
     */
    func demonstrateSetSublocationId() {
        print("--- setSublocationId Method ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_LocationWindow_setSublocationId]
        // Set sublocation ID to switch between floors
        locationWindow.setSublocationId(1)
        print("Set sublocation ID to 1 (first floor)")
        // [swift_LocationWindow_setSublocationId]
 
        // [swift_LocationWindow_setSublocationId_2]
        // Set sublocation ID to another floor
        locationWindow.setSublocationId(2)
        print("Set sublocation ID to 2 (second floor)")
        // [swift_LocationWindow_setSublocationId_2]
 
        // [swift_LocationWindow_setSublocationId_3]
        // Set sublocation ID to ground floor
        locationWindow.setSublocationId(0)
        print("Set sublocation ID to 0 (ground floor)")
        // [swift_LocationWindow_setSublocationId_3]
 
        // Test with different sublocation IDs
        let sublocationIds = [1, 2, 3, 0, 5]
        for id in sublocationIds {
            locationWindow.setSublocationId(id)
            print("Switched to sublocation ID: \‍(id)")
        }
    }
 
    /**
     * Demonstrate getters for sublocation and enclosing camera
     */
    func demonstrateSublocationQueries() {
        print("--- getSublocationId & getEnclosingCamera ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_LocationWindow_getSublocationId]
        if let currentId = locationWindow.getSublocationId() {
            print("Current sublocation id: \‍(currentId)")
        } else {
            print("Current sublocation id is not set")
        }
        // [swift_LocationWindow_getSublocationId]
 
        // [swift_LocationWindow_getEnclosingCamera]
        let boundingBox = BoundingBox(
            bottomLeft: GlobalPoint(latitude: 55.75, longitude: 37.61),
            topRight: GlobalPoint(latitude: 55.76, longitude: 37.63))
        let camera = locationWindow.getEnclosingCamera(boundingBox)
        print("Camera that fits bounding box: \‍(camera)")
        // [swift_LocationWindow_getEnclosingCamera]
 
        // [swift_LocationWindow_setFocusRect]
        let focus = ScreenRect(
            topLeft: ScreenPoint(x: 0, y: 0),
            bottomRight: ScreenPoint(x: 1000, y: 1600))
        locationWindow.setFocusRect(focus)
        // [swift_LocationWindow_setFocusRect]
 
        // [swift_LocationWindow_getEnclosingCameraWithFocus]
        let padded = locationWindow.getEnclosingCameraWithFocus(
            boundingBox, focusRect: focus, azimuth: nil, tilt: nil)
        print("Camera that fits bounding box in focus rect: \‍(padded)")
        // [swift_LocationWindow_getEnclosingCameraWithFocus]
    }
 
    /**
     * Demonstrate sublocation change listener usage
     */
    func demonstrateSublocationChangeListener() {
        print("--- Sublocation Change Listener ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        let listener = DemoSublocationChangeListener()
 
        // [swift_LocationWindow_addSublocationChangeListener]
        locationWindow.addSublocationChangeListener(listener)
        print("Added sublocation change listener")
        // [swift_LocationWindow_addSublocationChangeListener]
 
        locationWindow.setSublocationId(1)
        locationWindow.setSublocationId(2)
 
        // [swift_LocationWindow_removeSublocationChangeListener]
        locationWindow.removeSublocationChangeListener(listener)
        print("Removed sublocation change listener")
        // [swift_LocationWindow_removeSublocationChangeListener]
    }
 
    /**
     * Demonstrate user location layer controls
     */
    func demonstrateUserLocationLayer() {
        print("--- UserLocationLayer ---")
 
        guard let userLocationLayer = userLocationLayer else {
            print("UserLocationLayer not available yet")
            return
        }
 
        // [swift_UserLocationLayer_setVisible]
        userLocationLayer.setVisible(true)
        print("User location layer set visible")
        // [swift_UserLocationLayer_setVisible]
 
        // [swift_UserLocationLayer_isVisible]
        let visible = userLocationLayer.isVisible()
        print("User location layer is visible: \‍(visible)")
        // [swift_UserLocationLayer_isVisible]
 
        // [swift_UserLocationLayer_setAnchor]
        let anchor = ScreenPoint(x: 100.0, y: 200.0)
        userLocationLayer.setAnchor(anchor)
        print("Set user location anchor to: (\‍(anchor.x), \‍(anchor.y))")
        // [swift_UserLocationLayer_setAnchor]
 
        // [swift_UserLocationLayer_anchorEnabled]
        let anchorEnabled = userLocationLayer.anchorEnabled()
        print("Anchor enabled: \‍(anchorEnabled)")
        // [swift_UserLocationLayer_anchorEnabled]
 
        // [swift_UserLocationLayer_setHeadingModeActive]
        userLocationLayer.setHeadingModeActive(true)
        print("Heading-up mode enabled")
        // [swift_UserLocationLayer_setHeadingModeActive]
 
        // [swift_UserLocationLayer_headingModeActive]
        let headingModeActive = userLocationLayer.headingModeActive()
        print("Heading-up mode active: \‍(headingModeActive)")
        // [swift_UserLocationLayer_headingModeActive]
 
        // [swift_UserLocationLayer_setFollowMode]
        userLocationLayer.setFollowMode(.HEADING)
        print("Follow mode set to heading")
        // [swift_UserLocationLayer_setFollowMode]
 
        // [swift_UserLocationLayer_followMode]
        let followMode = userLocationLayer.followMode()
        print("Follow mode: \‍(followMode)")
        // [swift_UserLocationLayer_followMode]
 
        // [swift_UserLocationLayer_setArrowBitmap]
        if let arrow = UIImage(contentsOfFile: "/path/to/arrow.png") {
            userLocationLayer.setArrowBitmap(arrow)
        }
        userLocationLayer.setArrowBitmap(nil)
        print("Custom arrow bitmap cleared")
        // [swift_UserLocationLayer_setArrowBitmap]
 
        // [swift_UserLocationLayer_setAccuracyColor]
        userLocationLayer.setAccuracyColor(UIColor(red: 0.19, green: 0.67, blue: 0.85, alpha: 0.26))
        print("Accuracy circle color updated")
        // [swift_UserLocationLayer_setAccuracyColor]
 
        // [swift_UserLocationLayer_resetAnchor]
        userLocationLayer.resetAnchor()
        print("Anchor reset to default")
        // [swift_UserLocationLayer_resetAnchor]
    }
 
    /**
     * Demonstrate route layer controls
     */
    func demonstrateRouteLayer() {
        print("--- RouteLayer ---")
 
        guard let routeLayer = routeLayer else {
            print("RouteLayer not available yet")
            return
        }
 
        // [swift_RouteLayer_setVisible]
        routeLayer.setVisible(true)
        print("Route layer set visible")
        // [swift_RouteLayer_setVisible]
 
        // [swift_RouteLayer_isVisible]
        let visible = routeLayer.isVisible()
        print("Route layer is visible: \‍(visible)")
        // [swift_RouteLayer_isVisible]
 
        // [swift_RouteLayer_setTraveledColor]
        routeLayer.setTraveledColor(UIColor(red: 0.47, green: 0.47, blue: 0.47, alpha: 0.7))
        print("Traveled color updated")
        // [swift_RouteLayer_setTraveledColor]
 
        // [swift_RouteLayer_setRemainingColor]
        routeLayer.setRemainingColor(UIColor(red: 0.19, green: 0.67, blue: 0.85, alpha: 1.0))
        print("Remaining color updated")
        // [swift_RouteLayer_setRemainingColor]
 
        // [swift_RouteLayer_setWidth]
        routeLayer.setWidth(8.0)
        print("Route width updated")
        // [swift_RouteLayer_setWidth]
 
        // [swift_RouteLayer_setRemainingStyle]
        routeLayer.setRemainingStyle(.DOTTED)
        print("Remaining style set to DOTTED")
        // [swift_RouteLayer_setRemainingStyle]
 
        // [swift_RouteLayer_remainingStyle]
        let remainingStyle = routeLayer.remainingStyle()
        print("Remaining style: \‍(remainingStyle)")
        // [swift_RouteLayer_remainingStyle]
 
        // [swift_RouteLayer_setRemainingPointSize]
        routeLayer.setRemainingPointSize(8.0, height: 8.0)
        print("Remaining point size updated")
        // [swift_RouteLayer_setRemainingPointSize]
 
        // [swift_RouteLayer_setRemainingPlacement]
        routeLayer.setRemainingPlacement(.SPACED)
        print("Remaining placement updated")
        // [swift_RouteLayer_setRemainingPlacement]
 
        // [swift_RouteLayer_setRemainingPlacementSpacing]
        routeLayer.setRemainingPlacementSpacing(8.0)
        print("Remaining placement spacing updated")
        // [swift_RouteLayer_setRemainingPlacementSpacing]
 
        // [swift_RouteLayer_setRemainingPlacementMinRatio]
        routeLayer.setRemainingPlacementMinRatio(0.0)
        print("Remaining placement min ratio updated")
        // [swift_RouteLayer_setRemainingPlacementMinRatio]
 
        // [swift_RouteLayer_setRemainingCollisionEnabled]
        routeLayer.setRemainingCollisionEnabled(false)
        print("Remaining collision disabled")
        // [swift_RouteLayer_setRemainingCollisionEnabled]
 
        // [swift_RouteLayer_setRemainingDashLength]
        routeLayer.setRemainingDashLength(0.5)
        print("Remaining dash length updated")
        // [swift_RouteLayer_setRemainingDashLength]
 
        // [swift_RouteLayer_setRemainingGapLength]
        routeLayer.setRemainingGapLength(0.4)
        print("Remaining gap length updated")
        // [swift_RouteLayer_setRemainingGapLength]
 
        let from = RouteEndpoint(
            point: GlobalPoint(latitude: 55.751244, longitude: 37.618423),
            sublocationId: NSNumber(value: 1)) // nil for outdoor point
        let to = RouteEndpoint(
            point: GlobalPoint(latitude: 55.751700, longitude: 37.619000),
            sublocationId: NSNumber(value: 2)) // nil for outdoor point
 
        // [swift_RouteLayer_setRoute]
        routeLayer.setRoute(from, to: to)
        print("Static route applied")
        // [swift_RouteLayer_setRoute]
 
        // [swift_RouteLayer_setTarget]
        routeLayer.setTarget(to)
        print("Guidance target applied")
        // [swift_RouteLayer_setTarget]
 
        // [swift_RouteLayer_routes]
        let routes = routeLayer.routes()
        print("Visible routes: \‍(routes.count)")
        // [swift_RouteLayer_routes]
 
        // [swift_RouteLayer_selectedRoute]
        if let selectedRoute = routeLayer.selectedRoute() {
            print("Selected route length: \‍(selectedRoute.length())")
        }
        // [swift_RouteLayer_selectedRoute]
 
        // [swift_RouteLayer_selectRoute]
        if let firstRoute = routes.first {
            routeLayer.selectRoute(firstRoute)
        }
        // [swift_RouteLayer_selectRoute]
 
        // [swift_RouteLayer_addRouteLayerListener]
        routeLayerListener = DemoRouteLayerListener()
        routeLayer.addRouteLayerListener(routeLayerListener)
        // [swift_RouteLayer_addRouteLayerListener]
 
        // [swift_RouteLayer_addRouteViewListener]
        routeViewListener = DemoRouteViewListener(routeLayer: routeLayer)
        routeLayer.addRouteViewListener(routeViewListener)
        // [swift_RouteLayer_addRouteViewListener]
 
        // [swift_RouteLayer_clear]
        routeLayer.clear()
        print("Route layer cleared")
        // [swift_RouteLayer_clear]
    }
 
    /**
     * Demonstrate coordinate conversion methods
     */
    func demonstrateCoordinateConversion() {
        print("--- Coordinate Conversion Methods ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_LocationWindow_screenPositionToGlobal]
        let screenPoint = ScreenPoint(x: 100.0, y: 200.0)
        let globalPoint = locationWindow.screenPositionToGlobal(screenPoint)
        print("Screen position (\‍(screenPoint.x), \‍(screenPoint.y)) converted to WGS84: (\‍(globalPoint.latitude), \‍(globalPoint.longitude))")
        // [swift_LocationWindow_screenPositionToGlobal]
 
        // [swift_LocationWindow_getVisibleRegion]
        let visibleRegion = locationWindow.visibleRegion
        print("Viewport top-left: \‍(visibleRegion.topLeft)")
        // [swift_LocationWindow_getVisibleRegion]
 
        // [swift_LocationWindow_getFocusRegion]
        let focusRegion = locationWindow.focusRegion
        print("Focus-rect top-left: \‍(focusRegion.topLeft)")
        // [swift_LocationWindow_getFocusRegion]
 
        // [swift_LocationWindow_globalToScreenPosition]
        let globalPoint2 = GlobalPoint(latitude: 55.7558, longitude: 37.6176)
        let screenPoint2 = locationWindow.globalToScreenPosition(globalPoint2, clipToViewport: true)
        print("WGS84 (\‍(globalPoint2.latitude), \‍(globalPoint2.longitude)) converted to screen with clipping: (\‍(screenPoint2.x), \‍(screenPoint2.y))")
        // [swift_LocationWindow_globalToScreenPosition]
 
        let testScreenPoints = [
            ScreenPoint(x: 0.0, y: 0.0),
            ScreenPoint(x: 250.0, y: 250.0),
            ScreenPoint(x: 1000.0, y: 600.0)
        ]
 
        for (index, screenPoint) in testScreenPoints.enumerated() {
            let global = locationWindow.screenPositionToGlobal(screenPoint)
            let backToScreen = locationWindow.globalToScreenPosition(global, clipToViewport: false)
            print("Test \‍(index): Screen (\‍(screenPoint.x), \‍(screenPoint.y)) -> WGS84 (\‍(global.latitude), \‍(global.longitude)) -> Screen (\‍(backToScreen.x), \‍(backToScreen.y))")
        }
    }
 
    /**
     * Demonstrate map feature selection methods
     */
    func demonstrateMapFeatureSelection() {
        print("--- Map Feature Selection Methods ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_LocationWindow_selectMapFeature]
        // Select map feature by ID
        let featureId = "room_101"
        let selected = locationWindow.selectMapFeature(featureId)
        print("Selected map feature \‍(featureId): \‍(selected)")
        // [swift_LocationWindow_selectMapFeature]
 
        // [swift_LocationWindow_selectMapFeature_2]
        // Select another map feature
        let featureId2 = "office_205"
        let selected2 = locationWindow.selectMapFeature(featureId2)
        print("Selected map feature \‍(featureId2): \‍(selected2)")
        // [swift_LocationWindow_selectMapFeature_2]
 
        // [swift_LocationWindow_getSelectedMapFeatures]
        // Get list of selected map features
        let selectedFeatures = locationWindow.selectedMapFeatures
        print("Currently selected map features: \‍(selectedFeatures.count) features")
        for feature in selectedFeatures {
            print("  - \‍(feature)")
        }
        // [swift_LocationWindow_getSelectedMapFeatures]
 
        // [swift_LocationWindow_deselectMapFeature]
        // Deselect specific map feature
        let deselected = locationWindow.deselectMapFeature(featureId)
        print("Deselected map feature \‍(featureId): \‍(deselected)")
        // [swift_LocationWindow_deselectMapFeature]
 
        // [swift_LocationWindow_deselectMapFeature_2]
        // Deselect another map feature
        let deselected2 = locationWindow.deselectMapFeature(featureId2)
        print("Deselected map feature \‍(featureId2): \‍(deselected2)")
        // [swift_LocationWindow_deselectMapFeature_2]
 
        // [swift_LocationWindow_deselectAllMapFeatures]
        // Deselect all map features
        locationWindow.deselectAllMapFeatures()
        print("Deselected all map features")
        // [swift_LocationWindow_deselectAllMapFeatures]
 
        // [swift_LocationWindow_getSelectedMapFeatures_2]
        // Verify all features are deselected
        let remainingFeatures = locationWindow.selectedMapFeatures
        print("Remaining selected features after deselect all: \‍(remainingFeatures.count) features")
        // [swift_LocationWindow_getSelectedMapFeatures_2]
 
        // Test multiple feature selection and deselection
        let testFeatureIds = ["room_101", "office_205", "meeting_room_301", "cafe_401"]
 
        // Select multiple features
        for featureId in testFeatureIds {
            let success = locationWindow.selectMapFeature(featureId)
            print("Selected feature \‍(featureId): \‍(success)")
        }
 
        // Check selected features
        let allSelected = locationWindow.selectedMapFeatures
        print("All selected features: \‍(allSelected.count) features")
 
        // Deselect all at once
        locationWindow.deselectAllMapFeatures()
        print("Deselected all features at once")
    }
 
    /**
     * Demonstrate applyLayerFilter method
     */
    func demonstrateApplyLayerFilter() {
        print("--- applyLayerFilter Method ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_MapFilterCondition_constructor]
        // Create filter condition: show only venues with category "Toilet" or "Cafe"
        let condition = NCMapFilterCondition(property: "category", values: ["Toilet", "Cafe"])
        // [swift_MapFilterCondition_constructor]
 
        // [swift_LocationWindow_applyLayerFilter]
        // Apply filter to venues layer
        let conditions = [NCMapFilterCondition(property: "category", values: ["Toilet", "Cafe"])]
        locationWindow.applyLayerFilter("venues", conditions: conditions)
        print("Applied layer filter: show venues with category Toilet or Cafe")
        // [swift_LocationWindow_applyLayerFilter]
 
        // Reset filter (show all venues)
        locationWindow.applyLayerFilter("venues", conditions: [])
        print("Reset layer filter: show all venues")
    }
 
    /**
     * Demonstrate zoom properties
     */
    func demonstrateZoomProperties() {
        print("--- Zoom Properties ---")
 
        guard let locationWindow = locationWindow else {
            print("LocationWindow not available yet")
            return
        }
 
        // [swift_LocationWindow_getZoomFactor]
        // Get current zoom factor
        let currentZoom = locationWindow.zoomFactor
        print("Current zoom factor: \‍(currentZoom)")
        // [swift_LocationWindow_getZoomFactor]
 
        // [swift_LocationWindow_setZoomFactor]
        // Set zoom factor
        locationWindow.zoomFactor = 150.0
        print("Set zoom factor to 150.0")
        // [swift_LocationWindow_setZoomFactor]
 
        // [swift_LocationWindow_getMinZoomFactor]
        // Get minimum zoom factor
        let minZoomFactor = locationWindow.minZoomFactor
        print("Minimum zoom factor: \‍(minZoomFactor)")
        // [swift_LocationWindow_getMinZoomFactor]
 
        // [swift_LocationWindow_setMinZoomFactor]
        // Set minimum zoom factor
        locationWindow.minZoomFactor = 50.0
        print("Set minimum zoom factor to 50.0")
        // [swift_LocationWindow_setMinZoomFactor]
 
        // [swift_LocationWindow_getMaxZoomFactor]
        // Get maximum zoom factor
        let maxZoomFactor = locationWindow.maxZoomFactor
        print("Maximum zoom factor: \‍(maxZoomFactor)")
        // [swift_LocationWindow_getMaxZoomFactor]
 
        // [swift_LocationWindow_setMaxZoomFactor]
        // Set maximum zoom factor
        locationWindow.maxZoomFactor = 300.0
        print("Set maximum zoom factor to 300.0")
        // [swift_LocationWindow_setMaxZoomFactor]
 
        // Test zoom factor changes
        let testZoomFactors = [100.0, 125.0, 150.0, 200.0, 250.0]
        for zoom in testZoomFactors {
            locationWindow.zoomFactor = zoom
            print("Changed zoom factor to: \‍(locationWindow.zoomFactor)")
        }
 
        // Test zoom limits
        print("Testing zoom limits...")
        locationWindow.zoomFactor = locationWindow.minZoomFactor
        print("Set to minimum zoom: \‍(locationWindow.zoomFactor)")
 
        locationWindow.zoomFactor = locationWindow.maxZoomFactor
        print("Set to maximum zoom: \‍(locationWindow.zoomFactor)")
 
        // Reset to default
        locationWindow.zoomFactor = 100.0
        print("Reset zoom factor to default: \‍(locationWindow.zoomFactor)")
    }
 
    /**
     * Main demonstration method
     */
    func runExample() {
        print("=== LocationWindowCommon Example ===")
 
        // Simulate LocationWindow initialization
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
            // TODO: User will implement LocationWindow initialization here
            // self.locationWindow = self.getLocationWindow()
 
            // Run demonstrations
            self.demonstrateLocationWindowCommonMethods()
 
            print("=== Example completed ===")
        }
    }
}
 
/**
 * Function to run the example
 */
func main() {
    let example = LocationWindowCommonExample()
    example.runExample()
 
    // Keep the program running for a bit to see the output
    RunLoop.main.run(until: Date().addingTimeInterval(2.0))
}
 
// Run the example
main()
 
class DemoSublocationChangeListener: NSObject, SublocationChangeListener {
    // [swift_SublocationChangeListener_onActiveSublocationChanged]
    func onActiveSublocationChanged(_ sublocationId: Int32) {
        print("Active sublocation changed to: \‍(sublocationId)")
    }
    // [swift_SublocationChangeListener_onActiveSublocationChanged]
}