Count vessels in a SAR scene

Count vessel-like targets in ONE Sentinel-1 or NISAR scene over an area, using CFAR detection. Costs 5 tokens per detection (a NISAR granule converted for the first time adds 1, and needs the plan's NISAR access); a scene the worker refuses (an unsupported combination, an area with no usable sea) is not charged. Get item_id from GET /api/v1/imagery first. Read caveats before quoting the count: it says when the land mask was unavailable (shoreline structures may be counted as vessels), how far from the coast detections were excluded (the default excludes vessels alongside a quay), and when the scene covers only part of the requested area — a partial-coverage count must not be compared with a full one as though the difference were vessels. This measures one scene at one time; to track a berth over time, create a monitored area with metric ships.

post/api/v1/ships

Request

  • Base URL: https://offnadir-delta.com
  • URL: https://offnadir-delta.com/api/v1/ships
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

collection'sentinel-1-grd' | 'sentinel-1-rtc' | 'NISAR_L2_GCOV_PROVISIONAL_V1' required

Catalog collection of the scene: Sentinel-1, or NISAR L-band (the granule is converted to a COG first, which costs extra tokens the first time).

item_idstring required

STAC item id of the scene, as returned by GET /api/v1/imagery.

bboxnumber[]

Area to search within the scene, [lon_min, lat_min, lon_max, lat_max] (WGS84). Must be under 120,000 km².

geometryobject

Alternative to bbox: a GeoJSON Polygon or MultiPolygon.

algorithm_version'auto' | 'v2' | 'v3'

Detector version. 'auto' picks the recommended version for the sensor.

Response

The detections, with the caveats that change what the count means.

summarystring
countinteger
shipsobject

GeoJSON FeatureCollection of the detections.

caveatsstring[]
sceneobject
processingobject

Algorithm version, configuration hash, land-mask source, sea ratio.

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.