Package Exports
- squid-sailing-signalk
- squid-sailing-signalk/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (squid-sailing-signalk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
squid-sailing-signalk
SignalK Plugin to inject forecast data from Squid Sailing service
Install & Use
Note: To use this plugin you need to request an apikey, see also https://www.squid-sailing.com/doc-api/ to get started.
Install the plugin through the SignalK plugin interface. After installation you may want to 'Activate' it through the SignalK Plugin Config interface, enter your pre-requested apikey and configure the output data you want to receive as new SignalK-values (environment.forecast.*), such as:
- Wind at an elevation of 10m, includes wind gusts at groundlevel
- Temperature at an elevation of 2m
- Pressure at mean sea level
- Relative humidity at an elevation of 2m
- Total cloud coverage
- Convective potential energy and lifted index
- Combined wave height, current and water temperature (BETA only)
- Snow coverage (BETA only)
- Precipitation rate / accumulated (BETA only)
Forecast Data
Forecast data is purely based on position - hence navigation.position needs to be present. Data will be queried on position change and/or regularily on an hourly-basis. For consistency navigation.gnss.antennaAltitude (GPS altitude) wil be captured and used to more accurately compensate atmospheric pressure data to the appropriate elevation; default is altitude = 0 (sea level). It may take the plugin a couple of minutes before showing output data, as it will need to get a position before requesting data from the squid-sailing API.
By default the plugin will update forecast information every hour based on the latest position with a potential given hourly offset. No information will be stored or tracked. The plugin shall adhere to meta-data units according to the SignalK definition.
API Note
While the squid-sailing software is functional and can be subscribed, the API-layer is still in BETA.
*** UPDATE *** Since beginning of 2024, the API-servers don't seem to be reachable any more.
Release Notes
- v0.1 - initial version
- v0.2 - dependencies update