LocationListManagerExample.swift

Go to the documentation of this file.

import Foundation
 
/**
 * LocationListManager usage example for Swift
 * Demonstrates working with location list management, downloading locations from server, and location information
 */
class LocationListManagerExample: NSObject {
    private var sdk: NavigineSdk?
    private var locationListManager: LocationListManager?
    private var locationListListener: LocationListListener?
 
    override init() {
        super.init()
        initializeSdk()
        setupLocationListListener()
    }
 
    /**
     * Initialize SDK and get managers
     */
    private func initializeSdk() {
        do {
            // [swift_NavigineSdk_getInstance]
            // Get SDK instance
            sdk = NavigineSdk.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_getLocationListManager]
            // Get LocationListManager for working with location lists
            locationListManager = sdk?.getLocationListManager()
            // [swift_NavigineSdk_getLocationListManager]
 
            if let locationListManager = locationListManager {
                print("LocationListManager successfully initialized")
            }
        } catch {
            print("Error initializing SDK: \‍(error)")
        }
    }
 
    /**
     * Setup location list listener
     */
    private func setupLocationListListener() {
        locationListListener = LocationListListenerImpl(example: self)
    }
 
    /**
     * Demonstrate LocationListManager methods
     */
    func demonstrateLocationListManagerMethods() {
        guard let manager = locationListManager, let listener = locationListListener else {
            print("LocationListManager not initialized")
            return
        }
 
        // [swift_LocationListManager_addLocationListListener]
        // Add location list listener
        manager.addLocationListListener(listener)
        print("Added location list listener")
        // [swift_LocationListManager_addLocationListListener]
 
        // [swift_LocationListManager_updateLocationList]
        // Force reload location list
        manager.updateLocationList()
        print("Requested location list update")
        // [swift_LocationListManager_updateLocationList]
 
        // [swift_LocationListManager_getLocationList]
        // Get current location list
        let currentLocationList = manager.getLocationList()
        print("Current location list contains \‍(currentLocationList.count) locations")
        demonstrateLocationList(currentLocationList)
        // [swift_LocationListManager_getLocationList]
 
        // Simulate some time passing for location list updates
        DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
            // [swift_LocationListManager_removeLocationListListener]
            // Remove location list listener
            manager.removeLocationListListener(listener)
            print("Removed location list listener")
            // [swift_LocationListManager_removeLocationListListener]
        }
    }
 
    /**
     * Demonstrate location list
     */
    func demonstrateLocationList(_ locationInfos: [Int: LocationInfo]) {
        if locationInfos.isEmpty {
            print("Location list is empty")
            return
        }
 
        print("=== Location List ===")
        locationInfos.forEach { (locationId, locationInfo) in
            demonstrateLocationInfo(locationInfo)
        }
        print("====================")
    }
 
    /**
     * Demonstrate LocationInfo usage
     */
    func demonstrateLocationInfo(_ locationInfo: LocationInfo) {
        // [swift_LocationInfo_getId]
        // Get location ID
        let id = locationInfo.id
        print("Location ID: \‍(id)")
        // [swift_LocationInfo_getId]
 
        // [swift_LocationInfo_getVersion]
        // Get location version
        let version = locationInfo.version
        print("Location version: \‍(version)")
        // [swift_LocationInfo_getVersion]
 
        // [swift_LocationInfo_getName]
        // Get location name
        let name = locationInfo.name
        print("Location name: \‍(name)")
        // [swift_LocationInfo_getName]
 
        print("---")
    }
 
    /**
     * Demonstrate error handling
     */
    func demonstrateErrorHandling(_ error: Error) {
        print("Handling location list error:")
        print("  Error message: \‍(error.localizedDescription)")
        print("  Error type: \‍(type(of: error))")
    }
 
    /**
     * Demonstrate advanced location list management features
     */
    func demonstrateAdvancedLocationListFeatures() {
        print("=== Advanced Location List Features ===")
 
        guard let manager = locationListManager else { return }
 
        // Add multiple listeners
        let listener1 = LocationListListenerImpl(example: self)
        let listener2 = LocationListListenerImpl(example: self)
 
        // [swift_LocationListManager_addLocationListListener_1]
        // Add first location list listener
        manager.addLocationListListener(listener1)
        print("Added first location list listener")
        // [swift_LocationListManager_addLocationListListener_1]
 
        DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
            // [swift_LocationListManager_addLocationListListener_2]
            // Add second location list listener
            manager.addLocationListListener(listener2)
            print("Added second location list listener")
            // [swift_LocationListManager_addLocationListListener_2]
 
            // Force update to trigger listeners
            manager.updateLocationList()
 
            DispatchQueue.main.asyncAfter(deadline: .now() + 3.0) {
                // Remove listeners
                // [swift_LocationListManager_removeLocationListListener_1]
                // Remove first location list listener
                manager.removeLocationListListener(listener1)
                print("Removed first location list listener")
                // [swift_LocationListManager_removeLocationListListener_1]
 
                DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
                    // [swift_LocationListManager_removeLocationListListener_2]
                    // Remove second location list listener
                    manager.removeLocationListListener(listener2)
                    print("Removed second location list listener")
                    // [swift_LocationListManager_removeLocationListListener_2]
                }
            }
        }
    }
 
    /**
     * Demonstrate location list simulation
     */
    func demonstrateLocationListSimulation() {
        print("=== Location List Simulation ===")
 
        // Simulate different types of locations
        let simulatedLocations: [Int: LocationInfo] = [
            1001: LocationInfo(id: 1001, version: 1, name: "Shopping Mall"),
            1002: LocationInfo(id: 1002, version: 2, name: "Office Building"),
            1003: LocationInfo(id: 1003, version: 1, name: "Airport Terminal"),
            1004: LocationInfo(id: 1004, version: 3, name: "University Campus")
        ]
 
        // Simulate location list loading
        DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
            print("Simulated location list loaded")
            self.demonstrateLocationList(simulatedLocations)
        }
 
        // Simulate location list update
        DispatchQueue.main.asyncAfter(deadline: .now() + 3.0) {
            let updatedLocations: [Int: LocationInfo] = [
                1001: LocationInfo(id: 1001, version: 2, name: "Shopping Mall - Updated"),
                1002: LocationInfo(id: 1002, version: 3, name: "Office Building - Updated"),
                1003: LocationInfo(id: 1003, version: 2, name: "Airport Terminal - Updated"),
                1004: LocationInfo(id: 1004, version: 4, name: "University Campus - Updated"),
                1005: LocationInfo(id: 1005, version: 1, name: "New Hospital")
            ]
            print("Simulated location list updated")
            self.demonstrateLocationList(updatedLocations)
        }
    }
 
    /**
     * Demonstrate location list listener management
     */
    func demonstrateLocationListListenerManagement() {
        print("=== Location List Listener Management ===")
 
        guard let manager = locationListManager else { return }
 
        // Create a test listener
        let testListener = LocationListListenerImpl(example: self)
 
        // Add listener
        manager.addLocationListListener(testListener)
        print("Added test location list listener")
 
        // Force update to trigger listener
        manager.updateLocationList()
 
        // Simulate some time passing
        DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
            // Remove listener
            manager.removeLocationListListener(testListener)
            print("Removed test location list listener")
        }
    }
 
    /**
     * Main demonstration method
     */
    func runExample() {
        print("=== LocationListManager Example ===")
        
        demonstrateLocationListManagerMethods()
        demonstrateLocationListListenerManagement()
        demonstrateAdvancedLocationListFeatures()
        demonstrateLocationListSimulation()
        
        // Wait a bit for location list operations
        DispatchQueue.main.asyncAfter(deadline: .now() + 5.0) {
            print("=== Example completed ===")
        }
    }
}
 
/**
 * LocationListListener implementation
 */
class LocationListListenerImpl: NSObject, LocationListListener {
    private weak var example: LocationListManagerExample?
 
    init(example: LocationListManagerExample) {
        self.example = example
        super.init()
    }
 
    // [swift_LocationListListener_onLocationListLoaded]
    func onLocationListLoaded(_ locationInfos: [Int: LocationInfo]) {
        print("Location list loaded")
        example?.demonstrateLocationList(locationInfos)
    }
    // [swift_LocationListListener_onLocationListLoaded]
 
    // [swift_LocationListListener_onLocationListFailed]
    func onLocationListFailed(_ error: Error) {
        print("Location list failed")
        example?.demonstrateErrorHandling(error)
    }
    // [swift_LocationListListener_onLocationListFailed]
}
 
/**
 * Function to run the example
 */
func main() {
    let example = LocationListManagerExample()
    example.runExample()
    
    // Keep the app running for a while to see the output
    RunLoop.main.run(until: Date().addingTimeInterval(10.0))
}
 
// Run the example
main()