https://github.com/pauljohanneskraft/aisvisualizer
An app to display ship routes from AIS files.
https://github.com/pauljohanneskraft/aisvisualizer
ais ais-data apple-maps boats map noaa-data noaa-historical-data sailing ships
Last synced: 3 months ago
JSON representation
An app to display ship routes from AIS files.
- Host: GitHub
- URL: https://github.com/pauljohanneskraft/aisvisualizer
- Owner: pauljohanneskraft
- License: mit
- Created: 2022-04-22T01:17:05.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-05-04T20:23:53.000Z (about 3 years ago)
- Last Synced: 2025-01-26T09:41:29.254Z (5 months ago)
- Topics: ais, ais-data, apple-maps, boats, map, noaa-data, noaa-historical-data, sailing, ships
- Language: Swift
- Homepage:
- Size: 271 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AISVisualizer
AISVisualizer is an app to display ship routes from AIS files on top of Apple Maps (MKMapView). It also allows to draw grids to visualize coordinate regions.
## Getting started
The app is currently only available as part of this repository. It is available for iOS 15+ and macOS 12+. To build the application, you will need to use Xcode 13.3+ and adapt code signing to your own team.
## App functionality
First, you can select AIS files with the following format. The app expects the first 4, the rest may be ommitted, since they are irrelevant for the computation of paths.
```
MMSI,BaseDateTime,LAT,LON,SOG,COG,Heading,VesselName,IMO,CallSign,VesselType,Status,Length,Width,Draft,Cargo,TransceiverClass
```
After selecting the files you want to `AISVisualizer` to read, tap `Continue`. It will take some time until the files are fully read (a file with 6,000,000 lines takes up to around 5 minutes - keep that in mind!). The progress is displayed as the count of already processed lines.
When the files are fully read, an Apple Maps view is displayed.
- On the navigation bar, you can switch between different map types.
- `Add Path` allows you to add a line to the map that follows a vessel's position over the given date range.
- `Add Grid` allows you to add multiple rectangles forming a grid in a given region.
- `Center` will set the map's visible region to show all of the overlays that are currently visible. If there are none, this option is disabled.
- `Reset` will remove all paths and grids from the map.
- `Close` will discard the information from the files read and get you back to the initial page of the app - you will need to wait again for the files to be read, even if you select the same files.
## Author
Paul Kraft
## Licence
AISVisualizer is available under the MIT license. See the LICENSE file for more info.