LocationWindowCommonExample.swift

Go to the documentation of this file.

import Foundation
import Dispatch
 
/**
 * 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?
 
    init() {
        demonstrateLocationWindowCommonMethods()
    }
 
    /**
     * Demonstrate LocationWindowCommon methods
     */
    func demonstrateLocationWindowCommonMethods() {
        print("=== LocationWindowCommon Methods ===")
 
        demonstrateSetSublocationId()
        demonstrateOperatingMode()
        demonstrateSublocationQueries()
        demonstrateSublocationChangeListener()
        demonstrateUserLocationLayer()
        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_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]
    }
 
    /**
     * 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_resetAnchor]
        userLocationLayer.resetAnchor()
        print("Anchor reset to default")
        // [swift_UserLocationLayer_resetAnchor]
    }
 
    /**
     * 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_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]
}