/

Ship Identification

Fuses AIS properties with the ship detection block output geometries.


Description

A processing block that annotates ship geometry features detected by the Ship Detection block with ship metadata of the Automatic Identification System (AIS): ship name, cargo, destination port, etc.

See this block on the marketplace.

How it works

Ship metadata is generated when the block queries the Exact Earth historical vessel points API and fuses the data to the ship geometries using iterative search.

The AIS signal is queried for a time range (max +/- 720 minutes or 12 hours) around the satellite scene acquisition date, with the default range of ±15 minutes centered on the scene acquisition date. E.g., for an acquisition date of 2020-01-20T16:45:56Z the AIS query is performed for 2020-01-20T16:30:56Z to 2020-01-20T17:00:56Z. The output is the ship-identifications GeoJSON file containing the ship geometries with the fused ship metadata, as well as the data.json containing the UP42 query properties.

ParameterOverview
minutesThe delta of time in minutes around the satellite scene acquisition date. The default value is 15. The maximum value is 720.

Example

A workflow with the following blocks:

{
  "oneatlas-spot-aoiclipped:1": {
    "bbox": [-79.53802155090332, 8.836891687944988, -79.51857162879944, 8.857933824636724],
    "ids": null,
    "time": "2019-08-17T00:00:00+00:00/2019-08-18T23:59:59+00:00",
    "limit": 1,
    "zoom_level": 17,
    "time_series": null,
    "max_cloud_cover": 100,
    "panchromatic_band": false
  },
  "tiling:1": {
    "nodata": null,
    "tile_width": 768,
    "tile_height": 768,
    "match_extents": false,
    "output_prefix": "",
    "augmentation_factor": 1,
    "discard_empty_tiles": true
  },
  "ship-detection:1": {},
  "ship-identification:1": {
    "minutes": 15
  }
}

Capabilities

Input

Output

To know more please check the block capabilities specifications.