Skip to content

AISStream.io Integration with Vessel Registry Support #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

joshuafuller
Copy link

AISStream.io Integration with Vessel Registry Support

Overview

This PR adds AISStream.io integration to AISCOT, enabling real-time maritime data ingestion from AISStream.io's websocket API. It includes vessel registry support with name caching and configurable message handling for improved situational awareness.

Implementation Details

  • Added new aisstream.py module with AISStreamClient class for handling websocket connections
  • Implemented message queue-based processing architecture for asynchronous handling
  • Added vessel registry support with caching of vessel names
  • Enhanced message handling with configurable filtering options
  • Integrated with existing CoT message generation framework

Configuration Changes

  • Updated example-config.ini with AISStream.io configuration options
  • Added support for bounding box definition to filter messages by geographic area
  • Added configurable message type filtering options
  • Support for API key configuration

Testing

  • Tested with various geographic regions including global maritime traffic and Gulf-specific areas
  • Verified CoT message generation and transmission to TAK server
  • Confirmed vessel data enrichment through registry lookups

Documentation Updates

  • Updated README.md with AISStream.io capabilities
  • Added configuration documentation in docs/configuration.md
  • Updated usage examples in docs/usage.md
  • Added version information in CHANGELOG.md

Joshua Fuller and others added 5 commits April 28, 2025 16:23
…egration, including usage notes and API key requirements.
…eamClient

- Introduced a new dictionary to track vessel positions by MMSI.
- Added method to update vessel positions with latitude and longitude.
- Enhanced message processing to handle various AIS message types, including AidsToNavigationReport and StaticDataReport.
- Improved error handling and logging for missing or invalid data.
- Updated registry with vessel static data and positions for enriched message output.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant