jcable / charts-plugin

Signal K Node server charts plugin

Signal K Node server Charts plugin

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

Usage

1. Install "Signal K Charts" plugin from Signal K Appstore

2. Specify "Charts path" in plugin configuration. Defaults to ${signalk-configuration-path}/charts

3. Put charts into selected path

4. Activate plugin

5. Use one of the client apps supporting Signal K charts, for example:

• Freeboard SK
• Tuktuk Chart Plotter

Supported chart formats

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

Publicly available MBTiles charts can be found from:

• NOAA Nautical charts, quick download cheat-sheet
• 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:

• GET /signalk/v1/api/resources/charts/ returns metadata for all available charts
• GET /signalk/v1/api/resources/charts/${identifier}/ returns metadata for selected chart
• GET /signalk/v1/api/resources/charts/${identifier}/${z}/${x}/${y} returns a single tile for selected chart

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.