dmadk/ais-view repository overview

⁠AisView

AisView allows aggregation and publishing of data from both real time and historic AIS data sources using REST.

AisView has 3 main functionalities:

• Realtime Streaming : Streaming of incoming AIS data with easy-to-use filtering
• Realtime Monitoring: Reporting of latest static and positional data from vessels
• Historical Querying : Historic querying of AIS data via AisStore⁠

⁠Getting started

Compile the code from the root of the project. Maven 3.0.4 (or later) and Java 7 is needed:

Unless you already have AisStore setup. The easiest way to get started is by using a freely available AIS stream.

Start up AisView by specifying the AisSources to listen to as parameters. Here we are using the freely available hd-sf.com:9009

⁠Realtime Streaming

At any point all messages that is received by AisView can be streamed in realtime to any REST based client. Either by curl'ing it from a command promt:

Or by opening the url in a browser: Browser: http://localhost:8090/stream⁠

The stream can be filtered in a number of ways

⁠Realtime Monitoring

⁠Historical Querying

⁠Area

An rectangular area can be specified: (top left latitude, top left longitude, bottom right latitude, buttom left latitude) ?box=1,1,4,5

⁠Interval

Interval are specified as a ISO 8601 time interval. For example, ?interval=P1Y2M10DT2H30M/2008-05-11T15:30:00Z

⁠Modes

Two output modes are supported: Raw data or Table: ?output=raw or ?output=table

⁠MMSI

Filtering based on mmsi numbers:
?mmsi=123456789,234567890,333444555

⁠Limit

A limit can be placed on the number of packets that should be returned: ?limit=50 (will only return 50 packets)

⁠Source filtering

All packets can be filtered based on some property on the source they are received from

• Source Id: id
• Source Basestation: bs
• Source Country: country
• Source Type: type
• Source Region: region ?filter=id=AISD,2,3,4&region=23434