NavigationManagerExample.swift

Go to the documentation of this file.

import Foundation
 
/**
 * NavigationManager usage example for Swift
 * Demonstrates working with navigation, positioning, and location tracking
 */
class NavigationManagerExample: NSObject, NCPositionListener, NCLocationListener {
    private var sdk: NCNavigineSdk?
    private var locationManager: NCLocationManager?
    private var navigationManager: NCNavigationManager?
    
    override init() {
        super.init()
        initializeSdk()
    }
    
    /**
     * Initialize SDK and get managers
     */
    private func initializeSdk() {
        do {
            // [swift_NavigineSdk_getInstance]
            // Get SDK instance
            sdk = NCNavigineSdk.getInstance()
            // [swift_NavigineSdk_getInstance]
            
            // [swift_NavigineSdk_setUserHash]
            // Set user hash
            sdk?.setUserHash("USER-HASH-HERE")
            // [swift_NavigineSdk_setUserHash]
            
            // [swift_NavigineSdk_setServer]
            // Set server URL (optional)
            sdk?.setServer("https://custom.navigine.com")
            // [swift_NavigineSdk_setServer]
            
            // [swift_NavigineSdk_getLocationManager]
            // Get LocationManager for working with locations
            locationManager = sdk?.getLocationManager()
            // [swift_NavigineSdk_getLocationManager]
            
            // [swift_NavigineSdk_getNavigationManager]
            // Get NavigationManager for working with navigation
            navigationManager = sdk?.getNavigationManager(locationManager)
            // [swift_NavigineSdk_getNavigationManager]
            
            if locationManager != nil && navigationManager != nil {
                print("LocationManager and NavigationManager successfully initialized")
            }
        } catch {
            print("Error initializing SDK: \‍(error)")
        }
    }
    
    /**
     * Demonstrate NavigationManager methods
     */
    func demonstrateNavigationManagerMethods() {
        guard let manager = navigationManager else {
            print("NavigationManager not initialized")
            return
        }
        
        // [swift_NavigationManager_addPositionListener]
        // Add position listener
        manager.addPositionListener(self)
        // [swift_NavigationManager_addPositionListener]
        
        // [swift_NavigationManager_startLogRecording]
        // Start log recording
        manager.startLogRecording()
        // [swift_NavigationManager_startLogRecording]
        
        // [swift_NavigationManager_addCheckPoint]
        // Add check point
        let point = NCPoint(x: 10.0, y: 20.0)
        let locationPoint = NCLocationPoint(point: point, locationId: 12345, sublocationId: 1)
        manager.addCheckPoint(locationPoint)
        // [swift_NavigationManager_addCheckPoint]
        
        // [swift_NavigationManager_addLocationMeasurement]
        // Add location measurement
        let globalPoint = NCGlobalPoint(latitude: 55.7558, longitude: 37.6176) // Moscow coordinates
        manager.addLocationMeasurement(globalPoint, accuracy: 5.0, provider: "gps")
        // [swift_NavigationManager_addLocationMeasurement]
        
        // [swift_NavigationManager_stopLogRecording]
        // Stop log recording
        manager.stopLogRecording()
        // [swift_NavigationManager_stopLogRecording]
    }
    
    /**
     * Demonstrate Position class methods
     */
    func demonstratePositionUsage(_ position: NCPosition) {
        // [swift_Position_getPoint]
        // Get global point (WGS84 coordinates)
        if let globalPoint = position.getPoint() {
            demonstrateGlobalPointUsage(globalPoint)
        }
        // [swift_Position_getPoint]
        
        // [swift_Position_getAccuracy]
        // Get position accuracy
        let accuracy = position.getAccuracy()
        print("Position accuracy: \‍(accuracy) meters")
        // [swift_Position_getAccuracy]
        
        // [swift_Position_getHeading]
        // Get heading (angle of rotation about the -Z axis in radians)
        if let heading = position.getHeading() {
            print("Heading: \‍(heading) radians")
        }
        // [swift_Position_getHeading]
        
        // [swift_Position_getHeadingAccuracy]
        // Get heading accuracy
        if let headingAccuracy = position.getHeadingAccuracy() {
            print("Heading accuracy: \‍(headingAccuracy) radians")
        }
        // [swift_Position_getHeadingAccuracy]
        
        // [swift_Position_getLocationPoint]
        // Get location point (metrics coordinates)
        if let locationPoint = position.getLocationPoint() {
            demonstrateLocationPointUsage(locationPoint)
        }
        // [swift_Position_getLocationPoint]
        
        // [swift_Position_getLocationHeading]
        // Get location heading (with respect to sublocation north)
        if let locationHeading = position.getLocationHeading() {
            print("Location heading: \‍(locationHeading) radians")
        }
        // [swift_Position_getLocationHeading]
    }
    
    /**
     * Demonstrate GlobalPoint class methods
     */
    func demonstrateGlobalPointUsage(_ globalPoint: NCGlobalPoint) {
        // [swift_GlobalPoint_getLatitude]
        // Get latitude
        let latitude = globalPoint.getLatitude()
        print("Latitude: \‍(latitude)")
        // [swift_GlobalPoint_getLatitude]
        
        // [swift_GlobalPoint_getLongitude]
        // Get longitude
        let longitude = globalPoint.getLongitude()
        print("Longitude: \‍(longitude)")
        // [swift_GlobalPoint_getLongitude]
        
        // [swift_GlobalPoint_constructor]
        // Create new GlobalPoint
        let newPoint = NCGlobalPoint(latitude: latitude, longitude: longitude)
        print("Created new GlobalPoint: \‍(newPoint)")
        // [swift_GlobalPoint_constructor]
    }
    
    /**
     * Demonstrate LocationPoint class methods
     */
    func demonstrateLocationPointUsage(_ locationPoint: NCLocationPoint) {
        // [swift_LocationPoint_getPoint]
        // Get point coordinates
        if let point = locationPoint.getPoint() {
            demonstratePointUsage(point)
        }
        // [swift_LocationPoint_getPoint]
        
        // [swift_LocationPoint_getLocationId]
        // Get location ID
        let locationId = locationPoint.getLocationId()
        print("Location ID: \‍(locationId)")
        // [swift_LocationPoint_getLocationId]
        
        // [swift_LocationPoint_getSublocationId]
        // Get sublocation ID
        let sublocationId = locationPoint.getSublocationId()
        print("Sublocation ID: \‍(sublocationId)")
        // [swift_LocationPoint_getSublocationId]
        
        // [swift_LocationPoint_constructor]
        // Create new LocationPoint
        let newPoint = NCPoint(x: 15.0, y: 25.0)
        let newLocationPoint = NCLocationPoint(point: newPoint, locationId: locationId, sublocationId: sublocationId)
        print("Created new LocationPoint: \‍(newLocationPoint)")
        // [swift_LocationPoint_constructor]
    }
    
    /**
     * Demonstrate Point class methods
     */
    func demonstratePointUsage(_ point: NCPoint) {
        // [swift_Point_getX]
        // Get X coordinate
        let x = point.getX()
        print("Point X: \‍(x)")
        // [swift_Point_getX]
        
        // [swift_Point_getY]
        // Get Y coordinate
        let y = point.getY()
        print("Point Y: \‍(y)")
        // [swift_Point_getY]
        
        // [swift_Point_constructor]
        // Create new Point
        let newPoint = NCPoint(x: x, y: y)
        print("Created new Point: \‍(newPoint)")
        // [swift_Point_constructor]
    }
    
    /**
     * Demonstrate LocationManager integration
     */
    func demonstrateLocationManagerIntegration() {
        guard let manager = locationManager else {
            print("LocationManager not initialized")
            return
        }
        
        // [swift_LocationManager_addLocationListener]
        // Add location listener for navigation integration
        manager.addLocationListener(self)
        // [swift_LocationManager_addLocationListener]
        
        // [swift_LocationManager_setLocationId]
        // Set location ID to load
        manager.setLocationId(12345)
        // [swift_LocationManager_setLocationId]
        
        // [swift_LocationManager_getLocationId]
        // Get current location ID
        let currentLocationId = manager.getLocationId()
        print("Current location ID: \‍(currentLocationId)")
        // [swift_LocationManager_getLocationId]
        
        // [swift_LocationManager_setLocationUpdateInterval]
        // Set location update interval
        manager.setLocationUpdateInterval(300) // 5 minutes
        // [swift_LocationManager_setLocationUpdateInterval]
        
        // [swift_LocationManager_commitChanges]
        // Commit changes
        manager.commitChanges()
        // [swift_LocationManager_commitChanges]
    }
    
    /**
     * Demonstrate advanced navigation features
     */
    func demonstrateAdvancedNavigationFeatures() {
        print("=== Advanced Navigation Features ===")
        
        guard let manager = navigationManager else {
            return
        }
        
        // Create multiple check points for path tracking
        let checkPoints = [
            NCPoint(x: 0.0, y: 0.0),
            NCPoint(x: 10.0, y: 10.0),
            NCPoint(x: 20.0, y: 20.0),
            NCPoint(x: 30.0, y: 30.0)
        ]
        
        for (index, point) in checkPoints.enumerated() {
            let locationPoint = NCLocationPoint(point: point, locationId: 12345, sublocationId: 1)
            // [swift_NavigationManager_addCheckPoint]
            // Add check point for path tracking
            manager.addCheckPoint(locationPoint)
            // [swift_NavigationManager_addCheckPoint]
            print("Added check point \‍(index + 1): \‍(locationPoint)")
        }
        
        // Add location measurements with different providers
        let measurements = [
            NCGlobalPoint(latitude: 55.7558, longitude: 37.6176), // Moscow
            NCGlobalPoint(latitude: 40.7128, longitude: -74.0060), // New York
            NCGlobalPoint(latitude: 51.5074, longitude: -0.1278)  // London
        ]
        
        let providers = ["gps", "network", "fused"]
        
        for (index, globalPoint) in measurements.enumerated() {
            // [swift_NavigationManager_addLocationMeasurement]
            // Add location measurement with different providers
            manager.addLocationMeasurement(globalPoint, accuracy: 3.0 + Double(index), provider: providers[index % providers.count])
            // [swift_NavigationManager_addLocationMeasurement]
            print("Added measurement \‍(index + 1) with provider: \‍(providers[index % providers.count])")
        }
    }
    
    /**
     * Demonstrate position tracking simulation
     */
    func demonstratePositionTrackingSimulation() {
        print("=== Position Tracking Simulation ===")
        
        guard let manager = navigationManager else {
            return
        }
        
        // [swift_NavigationManager_startLogRecording]
        // Start log recording for position tracking
        manager.startLogRecording()
        // [swift_NavigationManager_startLogRecording]
        
        // Simulate position updates
        for i in 0..<5 {
            let lat = 55.7558 + (Double(i) * 0.001) // Move north
            let lon = 37.6176 + (Double(i) * 0.001) // Move east
            
            let globalPoint = NCGlobalPoint(latitude: lat, longitude: lon)
            // [swift_NavigationManager_addLocationMeasurement]
            // Add simulated location measurement
            manager.addLocationMeasurement(globalPoint, accuracy: 2.0, provider: "simulated")
            // [swift_NavigationManager_addLocationMeasurement]
            
            print("Simulated position \‍(i + 1): \‍(globalPoint)")
            
            Thread.sleep(forTimeInterval: 1.0) // Wait 1 second between updates
        }
        
        // [swift_NavigationManager_stopLogRecording]
        // Stop log recording
        manager.stopLogRecording()
        // [swift_NavigationManager_stopLogRecording]
    }
    
    /**
     * Clean up resources
     */
    func cleanup() {
        if let manager = navigationManager {
            // [swift_NavigationManager_removePositionListener]
            // Remove position listener
            manager.removePositionListener(self)
            // [swift_NavigationManager_removePositionListener]
        }
    }
    
    /**
     * Main demonstration method
     */
    func runExample() {
        print("=== NavigationManager Example ===")
        
        demonstrateNavigationManagerMethods()
        demonstrateLocationManagerIntegration()
        demonstrateAdvancedNavigationFeatures()
        demonstratePositionTrackingSimulation()
        
        // Wait a bit for position updates
        Thread.sleep(forTimeInterval: 3.0)
        
        cleanup()
        print("=== Example completed ===")
    }
}
 
// MARK: - NCPositionListener
 
extension NavigationManagerExample {
    // [swift_PositionListener_onPositionUpdated]
    func onPositionUpdated(_ position: NCPosition) {
        print("Position updated successfully")
        demonstratePositionUsage(position)
    }
    // [swift_PositionListener_onPositionUpdated]
    
    // [swift_PositionListener_onPositionError]
    func onPositionError(_ error: Error?) {
        if let error = error {
            print("Position error: \‍(error.localizedDescription)")
        }
    }
    // [swift_PositionListener_onPositionError]
}
 
// MARK: - NCLocationListener
 
extension NavigationManagerExample {
    // [swift_LocationListener_onLocationLoaded]
    func onLocationLoaded(_ location: NCLocation?) {
        print("Location loaded for navigation")
        if let location = location {
            // [swift_LocationManager_setLocationId]
            // Set location ID for navigation
            locationManager?.setLocationId(location.getId())
            // [swift_LocationManager_setLocationId]
        }
    }
    // [swift_LocationListener_onLocationLoaded]
    
    // [swift_LocationListener_onLocationUploaded]
    func onLocationUploaded(_ locationId: Int32) {
        print("Location uploaded: \‍(locationId)")
    }
    // [swift_LocationListener_onLocationUploaded]
    
    // [swift_LocationListener_onLocationFailed]
    func onLocationFailed(_ locationId: Int32, error: Error?) {
        if let error = error {
            print("Failed to load location \‍(locationId): \‍(error.localizedDescription)")
        }
    }
    // [swift_LocationListener_onLocationFailed]
}
 
/**
 * Function to run the example
 */
func main() {
    let example = NavigationManagerExample()
    example.runExample()
}
 
// Run the example
main()