/

AIS - Query Vessel by ID

Provides historical AIS data points for a vessel via the exactEarth HVP API.


Introduction

For more information, please read the block description.

Block type: DATA

This block provides access to historical data points of the Automatic Identification System (AIS). The block queries the Exact Earth historical vessel points API for one ore multiple ships by Maritime Mobile Service Identity (MMSI) or exactEarth Identifier (EEID) ids. It provides ship position point geometries and associated metadata e.g. ship name, cargo, destination port, etc. The output is a GeoJSON file ais-points.geojson that contains the AIS point geometries and properties, and a JSON file data.json that contains the UP42 query parameters.

Supported parameters

For more information, please read the section Data source query filters.

  • mmsi: Ids of Maritime Mobile Service Identity (MMSI), e.g. ["832732821", "948212991"].

  • eeid: Ids of exactEarth Identifier (eEID), proprietary id of the exactEarth services (given to vessels based on their underlying characteristics), e.g. ["0945377234823382332", "82137382388238372"].

  • time: A date range to filter the data points on. This range applies to the acquisition date/time of the AIS signals. Maximum of 7 days.

Example queries

Example query using time in combination with mmsi:

{
  "exactearth-ais-query-vessel:1": {
    "mmsi": [
        "832732821", "948212991"
    ],
    "time": "2019-01-01T10:00:00+00:00/2019-01-01T13:59:59+00:00",
  }
}

Output format

Output format is a GeoJSON file, see GeoJSON for a more detailed description.

{
    "type": "FeatureCollection",
    "crs": {
            "type": "name",
            "properties": {
                    "name": "urn:ogc:def:crs:OGC:1.3:CRS84"
            }
    },
    "features": [{
            "type": "Feature",
            "properties": {
                    "mmsi": 832732821,
                    "imo": 8959245,
                    "vessel_name": "SAN MARCO",
                    "callsign": "UWHW",
                    "vessel_type": "Unknown",
                    "vessel_type_code": 100,
                    "vessel_type_cargo": "",
                    "vessel_class": "A",
                    "length": 56,
                    "width": 11,
                    "flag_country": "Italy",
                    "flag_code": 247,
                    "destination": "PELLESTRINA",
                    "eta": "06141100",
                    "draught": 6,
                    "longitude": 12.35449,
                    "latitude": 45.428425,
                    "sog": 8.5,
                    "cog": 310.7,
                    "rot": 0,
                    "heading": 0,
                    "nav_status": "Under Way Using Engine",
                    "nav_status_code": 0,
                    "source": "T-AIS",
                    "ts_pos_utc": "20190101100147",
                    "ts_static_utc": "20181228232109",
                    "dt_pos_utc": "2019-01-01 10:01:47",
                    "dt_static_utc": "2018-12-28 23:21:09",
                    "vessel_type_main": "Passenger Ship",
                    "vessel_type_sub": "Passenger Ro Ro Cargo Ship",
                    "message_type": 1,
                    "eeid": 5678668990079917276,
                    "dtg": "2019-01-01T10:01:47Z"
            },
            "geometry": {
                    "type": "Point",
                    "coordinates": [15.32323, 23.42132]
            }
    }]
}

Capabilities

Output

To know more please check the block capabilities specifications.