ASAM - Anti-Shipping Activity Messages Data Downloader

A multi-language implementation for downloading maritime piracy data (ASAM - Anti-Shipping Activity Messages) from the Maritime Optima API. This project provides three equivalent implementations in Go, Node.js/TypeScript, and R for fetching real-time piracy incident data in GeoJSON format.

Overview

The ASAM downloaders authenticate with the Maritime Optima API and download the latest piracy incident data, which includes:

• Piracy attacks and attempted attacks
• Maritime security incidents
• Suspicious vessel activities
• Geographic coordinates and incident details

All three implementations perform the same core functions:

1. Authenticate with Maritime Optima API using email/password credentials
2. Obtain a JWT token for authorized access
3. Download piracy data in GeoJSON format
4. Save the data with a date-stamped filename

Prerequisites

Environment Variables

All implementations require the following environment variables:

export MARITIME_OPTIMA_EMAIL="your-email@example.com"
export MARITIME_OPTIMA_PASSWORD="your-password"