Get SAR vessel detections cell details | Global Fishing Watch API

Example Interaction request returning the SAR vessel detections behind a single tile cell.

Path parameters

Parameter	Value	Description
`z/x/y/cells`	`0/0/0/1049`	Tile coordinates and cell index

Query parameters

Parameter	Value	Description
`datasets[0]`	`public-global-sar-presence:latest`	SAR vessel detections dataset
`date-range`	`2017-01-01,2021-12-31`	Filter to 2017-2021

Request

# Make sure to replace [TOKEN] with your API Access Token.
curl --location --globoff 'https://gateway.api.globalfishingwatch.org/v3/4wings/interaction/0/0/0/1049?datasets[0]=public-global-sar-presence%3Alatest&date-range=2017-01-01%2C2021-12-31' \
  -H "Authorization: Bearer [TOKEN]"

// Make sure to replace [TOKEN] with your API Access Token.
const res = await fetch(
  'https://gateway.api.globalfishingwatch.org/v3/4wings/interaction/0/0/0/1049?datasets[0]=public-global-sar-presence%3Alatest&date-range=2017-01-01%2C2021-12-31',
  { headers: { Authorization: 'Bearer [TOKEN]' } }
)
const data = await res.json()

Response

detections and vessel id (in the case there is matching) that allow you to get more detail of a vessel by using the Vessel API

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    [
      {
        "detections": 1,
        "timestamp": "2019-01-02T00:11:17Z",
        "vessel_id": "f9cceefc5-5c63-e34a-c660-14060bc5ebe6"
      },
      {
        "detections": 1,
        "timestamp": "2020-04-14T09:44:30Z",
        "vessel_id": "f7e478e4d-de52-230b-9f67-9e3c47030786"
      },
      {
        "detections": 1,
        "timestamp": "2018-08-23T00:11:17Z",
        "vessel_id": "f67b7ac6c-c819-e6aa-6ecc-62faf34106c8"
      }
    ]
  ]
}