Signal K server Charts plugin

Signal K Node server plugin to provide chart metadata, such as name, description and location of the actual chart tile data.

Chart metadata is derived from the following supported chart file types:

• MBTiles (.mbtiles)
• TMS (tilemapresource.xml and tiles)

Additionally, chart metadata can be entered via the plugin configuration for other chart sources and types (e.g. WMS, WMTS, S-57 tiles and tilejson).

Chart metadata is made available to both v1 and v2 Signal K resources api paths.

| Server Version | API | Path | |--- |--- |--- | | 1.x.x | v1 | /signalk/v1/api/resources/charts | | 2.x.x | v2 | /signalk/v2/api/resources/charts |

Note: Version 2 resource paths will only be made available on Signal K server v2.0.0 and later

Usage

1. Install @signalk/signalk-charts from the Signal K Server Appstore

2. Configure the plugin in the Admin UI (Server -> Plugin Config -> Signal K Charts)

3. Activate the plugin

[!TIP] On Victron Venus devices you need to install some dependencies manually before installing the plugin.

Chart metadata will then be available to client apps via the resources api /resources/charts for example:

• Freeboard SK
• Tuktuk Chart Plotter

Configuration

Local Chart Files

To use chart files stored on the Signal K Server the plugin needs to know where your local chart files are stored to generate the chart metadata.

You can either:

1. Put the chart files in the default location (/home/<user>/.signalk/charts)
2. Add configuration entries for the folders where the chart files are stored.

Note: After chart files have been added to folders they will be processed after the plugin has been restarted! (disable / enable the plugin)

Online chart providers

If your chart source is not local to the Signal K Server you can add "Online Chart Providers" and enter the required charts metadata for the source.

You will need to provide the following information:

1. A chart name for client applications to display
2. The URL to the chart source
3. Select the chart image format
4. The minimum and maximum zoom levels where chart data is available.

You can also provide a description detailing the chart content.

For WMS & WMTS sources you can specify the layers you wish to display.

A proxy for online charts can be created using the "Proxy through SignalK server" option. If enabled tiles will be fetched from the remote server and cached by the SignalK server making it possible to store the tiles for offline usage. Additional http headers can be passed to the remote server by adding colon separated headers, e.g. User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64). User-Agent is the header name and Mozilla... will be the value.

Supported chart formats

• MBTiles files
• Directory with cached TMS tiles and tilemapresource.xml
• Directory with XYZ tiles and metadata.json
• Online TMS

Publicly available MBTiles charts can be found from:

• NOAA Nautical charts
• Finnish Transport Agency nautical charts
• Signal K World Coastline Map, download MBTiles release

API

Plugin adds support for /resources/charts endpoints described in Signal K specification:

List available charts

GET /signalk/v2/api/resources/charts/` 

Return metadata for selected chart

GET /signalk/v2/api/resources/charts/${identifier}` 

Chart Tiles

Chart tiles are retrieved using the url defined in the chart metadata.

For local chart files located in the Chart Path(s) defined in the plugin configuration, the url will be:

/signalk/chart-tiles/${identifier}/${z}/${x}/${y}

License

Copyright 2018 Mikko Vesikkala

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.