Enumerations

The logs console output data amount level where error is a minimum amount and verbose is a maximum.

This affects only the console output and does not affect the internal logs file. Internal logs file will still log verbose level to have all details for future debugging.

See more

public enum LoggingLevel

Nowcast forecast hours.

See more

public enum NowcastHours : Int, Codable, CaseIterable, Comparable

Fetched from the server and own tracked data are stored locally on the device up to the maximum supported time. Removed when not needed anymore.

Using TurbulenceQuery.type it is possible to query for server-only data or own-only data. For example, when showing server and own tracked data on different map layers differently.

See more

public enum TurbulenceResultType

The aircraft size category.

See more

public enum AircraftSize : String, Codable

Based on AlertQuery and DataQuery configuration the alerts can be searched in different ways.

You don’t set this type but receive only for information purposes of how this alert was found.

See more

public enum AlertResultType

The data fetch from the server is separated by area types like route corridor, visible map viewport, and global (for some types only).

To reduce network traffic usage and have only data that is currently needed the data fetch is separated into the different area types. It is controlled by the SkyPath.dataQuery object that is set initially to default values and can be updated at any time.

Each area type is fetched by a separate server request. It can be used to update different data map layers if for example route and viewport data are on different layers.

See more

public enum DataAreaType

When started, SDK fetches initial data from time back in time and then receives only updates since the last update. The server does some data precalculations so only the specified time frames are supported.

It determines the data history to be fetched from the server. So if it is set to .twoHours for example (the default one), there will be no data locally available for more than 2 hours ago. If need 4 hours of history, set SkyPath.dataHistoryTime to .fourHours.

See more

public enum DataHistoryTime : Double, Codable, CaseIterable, Comparable

It controls time intervals to fetch data for global turbulence polygons, route polygons, viewport, and other data.

When the data query route polygon or the viewport is changed, they are fetched as fast as possible not waiting for the next time interval. The default is fast.

Usage example:

SkyPath.shared.dataUpdateFrequency = .fast

To save network traffic, you can set it to none to disable periodic new data fetch from the server at all or set it to minimal to update with bigger time intervals. At first, the whole data for configured DataHistoryTime will be fetched and then only the difference will be received every time interval cycle.

Each case has a predefined time interval that you can’t change. At the moment, there are no differences between minimal, medium, and fast, but it’s subject to future change.

fast is recommended to use which is also set by default.

See more

public enum DataUpdateFrequency : String, Codable

Server environment used by SDK internal API routing. serverUrl is a base URL to access SkyPath service. Use nil to use the default domain (see each case details).

You can use a proxy server to avoid whitelisting a SkyPath domain. It should forward all HTTPS network traffic for api.skypath.io with a wildcard * for a path.

docs.skypath.io describes APIs to get data only as it’s not possible to send recorded data outside of SDK. SDK will use other not documented API endpoints, so whitelisting only those or any other fixed endpoints paths list is not sufficient.

See more

public enum Environment : Codable

Errors returned when making a query for alerts via SkyPath.alerts(with:).

Query is made among locally stored data. So an error will typically indicate that some properties of AlertQuery or configuration of DataQuery are invalid or insufficient.

See more

public enum AlertError : SPError

General SkyPath errors.

See more

public enum GeneralError : SPError

Errors returned when making a data query.

See more

public enum QueryError : SPError

Errors returned in a completion block when starting the SDK by SkyPath.start().

See more

public enum StartError : SPError

A severity level of a nowcast data.

See more

public enum NowcastSeverity : Int, Codable, Hashable, CaseIterable, Comparable

A severity level of a turbulence report.

It can vary for different aircraft types.

See more

public enum TurbulenceSeverity : Int, Equatable, Comparable, Codable, CaseIterable

Determined when new data is received by comparing it to the previously locally stored data.

Fetched from the server and own tracked data are stored locally on the device up to the maximum supported time and removed when not needed anymore.

When new data is received for a specific tile that has some data stored, and new data has a different aggregated max severity. Shows if the severity of this tile is getting worse or better.

See more

public enum TurbulenceTrend : String, Codable