Airport Data Swift

dependencies: [
    .package(url: "https://github.com/aashishvanand/airport-data-swift.git", from: "1.0.0")
]

.target(
    name: "YourTarget",
    dependencies: ["AirportData"]
)

public struct Airport {
    let iata: String              // 3-letter IATA code
    let icao: String              // 4-letter ICAO code
    let time: String              // Timezone identifier (e.g. "Asia/Singapore")
    let utc: Double               // UTC offset in hours
    let countryCode: String       // 2-letter ISO country code
    let continent: String         // 2-letter continent code (AS, EU, NA, SA, AF, OC, AN)
    let airport: String           // Airport name
    let latitude: Double          // Latitude coordinate
    let longitude: Double         // Longitude coordinate
    let elevationFt: Int?         // Elevation in feet
    let type: String              // Airport type
    let scheduledService: Bool    // Has scheduled commercial service
    let wikipedia: String         // Wikipedia URL
    let website: String           // Airport website URL
    let runwayLength: Int?        // Longest runway in feet
    let flightradar24Url: String  // Flightradar24 tracking URL
    let radarboxUrl: String       // RadarBox tracking URL
    let flightawareUrl: String    // FlightAware tracking URL
}

import AirportData

// Get airport by IATA code
let airports = try AirportData.getAirportByIata("SIN")
print(airports.first!.airport) // "Singapore Changi Airport"

// Get airport by ICAO code
let airports = try AirportData.getAirportByIcao("WSSS")
print(airports.first!.countryCode) // "SG"

// Search airports by name
let airports = try AirportData.searchByName("Singapore")
print(airports.count) // Multiple airports matching "Singapore"

// Find nearby airports (within 50km of coordinates)
let nearby = AirportData.findNearbyAirports(latitude: 1.35019, longitude: 103.994003, radiusKm: 50)
print(nearby) // Airports near Singapore Changi

let airports = try AirportData.getAirportByIata("LHR")
// Returns array of airports with IATA code 'LHR'

let airports = try AirportData.getAirportByIcao("EGLL")
// Returns array of airports with ICAO code 'EGLL'

let airports = try AirportData.searchByName("Heathrow")
// Returns airports with 'Heathrow' in their name

let nearby = AirportData.findNearbyAirports(latitude: 51.5074, longitude: -0.1278, radiusKm: 100)
// Returns airports within 100km of London, sorted by distance

let distance = try AirportData.calculateDistance("LHR", "JFK")
// Returns distance in kilometers (approximately 5540)

// Find nearest airport to coordinates
let nearest = AirportData.findNearestAirport(latitude: 1.35019, longitude: 103.994003)

// Find nearest large airport with scheduled service
let nearestHub = AirportData.findNearestAirport(
    latitude: 1.35019,
    longitude: 103.994003,
    filter: NearestAirportFilter(type: "large_airport", hasScheduledService: true)
)

let usAirports = try AirportData.getAirportByCountryCode("US")
// Returns all airports in the United States

let asianAirports = try AirportData.getAirportByContinent("AS")
// Continent codes: AS, EU, NA, SA, AF, OC, AN

let largeAirports = AirportData.getAirportsByType("large_airport")
// Types: large_airport, medium_airport, small_airport, heliport, seaplane_base

// Use "airport" to match all airport types
let allAirports = AirportData.getAirportsByType("airport")

let londonAirports = try AirportData.getAirportsByTimezone("Europe/London")

// Find large airports in Great Britain with scheduled service
let airports = AirportData.findAirports(AirportFilter(
    countryCode: "GB",
    type: "large_airport",
    hasScheduledService: true
))

// Find airports with minimum runway length
let longRunwayAirports = AirportData.findAirports(AirportFilter(
    minRunwayFt: 10000
))

let suggestions = AirportData.getAutocompleteSuggestions("Lon")
// Returns up to 10 airports matching 'Lon' in name or IATA code

let links = try AirportData.getAirportLinks("SIN")
// Returns AirportLinks with website, wikipedia, flightradar24, radarbox, flightaware

let stats = try AirportData.getAirportStatsByCountry("US")
print(stats.total)                // Total airports
print(stats.byType)               // Count by type
print(stats.withScheduledService)  // Airports with scheduled service
print(stats.averageRunwayLength)   // Average runway length in feet
print(stats.averageElevation)      // Average elevation in feet
print(stats.timezones)             // All timezones

let stats = try AirportData.getAirportStatsByContinent("AS")
print(stats.byCountry)  // Count by country code

// Top 5 by runway length
let airports = try AirportData.getLargestAirportsByContinent("AS", limit: 5, sortBy: "runway")

// Top 10 by elevation
let highAltitude = try AirportData.getLargestAirportsByContinent("SA", limit: 10, sortBy: "elevation")

let airports = AirportData.getMultipleAirports(["SIN", "LHR", "JFK", "WSSS"])
// Returns [Airport?] — nil for codes not found

let matrix = try AirportData.calculateDistanceMatrix(["SIN", "LHR", "JFK"])
// matrix.airports — info about each airport
// matrix.distances["SIN"]!["LHR"]! — distance in km

AirportData.validateIataCode("SIN")  // true
AirportData.validateIataCode("XYZ")  // false

AirportData.validateIcaoCode("WSSS")  // true
AirportData.validateIcaoCode("XXXX")  // false

let total = AirportData.getAirportCount()

let count = AirportData.getAirportCount(AirportFilter(
    countryCode: "US",
    type: "large_airport"
))

let operational = try AirportData.isAirportOperational("SIN")  // true

do {
    let airport = try AirportData.getAirportByIata("XYZ")
} catch let error as AirportDataError {
    print(error.localizedDescription)  // "No data found for IATA code: XYZ"
}

let parisAirports = AirportData.findNearbyAirports(latitude: 48.8566, longitude: 2.3522, radiusKm: 100)
print("Found \(parisAirports.count) airports near Paris")
for result in parisAirports {
    print("\(result.airport.iata) - \(result.airport.airport) (\(Int(result.distance)) km)")
}

let distance = try AirportData.calculateDistance("SIN", "LHR")
print("Distance: \(Int(distance)) km")

let suggestions = AirportData.getAutocompleteSuggestions("New York")
for airport in suggestions {
    print("\(airport.iata) - \(airport.airport)")
}

let asianHubs = AirportData.findAirports(AirportFilter(
    continent: "AS",
    type: "large_airport",
    hasScheduledService: true
))

let usStats = try AirportData.getAirportStatsByCountry("US")
print("Total airports: \(usStats.total)")
print("Large airports: \(usStats.byType["large_airport"] ?? 0)")
print("Average runway length: \(Int(usStats.averageRunwayLength)) ft")

let airports = AirportData.getMultipleAirports(["SIN", "LHR", "JFK", "NRT"])
for airport in airports.compactMap({ $0 }) {
    print("\(airport.iata): \(airport.airport)")
}

let matrix = try AirportData.calculateDistanceMatrix(["SIN", "LHR", "JFK"])
print("SIN to LHR: \(Int(matrix.distances["SIN"]!["LHR"]!)) km")
print("LHR to JFK: \(Int(matrix.distances["LHR"]!["JFK"]!)) km")

let codes = ["SIN", "XYZ", "LHR"]
for code in codes {
    let isValid = AirportData.validateIataCode(code)
    print("\(code): \(isValid ? "Valid" : "Invalid")")
}