Ship Identification

Annotates ship geometry features detected by the Ship Detection block.


For more information, please read the block description.

Block type: PROCESSING

This block 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. This 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 being the a range of +-15 minutes centered at 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 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.

Supported parameters

  • minutes: Delta of time in minutes around the satellite scene acquisition date for
querying the AIS data feed (default: 15, maximum: 720)

Example usage

Example running the full Ship Identification workflow (SPOT 6/7 Display (Streaming) → Tiling → Airbus Ship Detection → AIS Ship Identification).

  "oneatlas-spot-aoiclipped:1": {
    "bbox": [
    "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

Output format

Output format is a GeoJSON.