Skip to content

← API reference

Nearest vessels reporting AIS positions

vessel_traffic8 fields8 of these fields open in the demo
Source
BarentsWatch / Kystverket AIS snapshot
Geography
Around the address
Reported stale after
2 hours
Access
Requires an API key granted this section
Contract version
1
In packages
environment_nuisance

What this does not say

Quoted verbatim from the section’s warnings field, exactly as the API returns it. They are not translated: a translation would show something other than what your response actually contains.

  • Latest known position per vessel within roughly 10 km, from the last six hours; a snapshot of shipping activity, not a traffic statistic. Vessel identifiers are public AIS data.

Fields

2 of 8 fields are value fields — the ones that decide whether a record actually says anything. The rest are context: identifiers, codes and timestamps. Fields marked “open” return values to anonymous callers; the rest require a key.

FieldTypeRoleDemo
mmsistring | nullcontextopen
ship_namestring | nullvalueopen
ship_typeinteger | nullcontextopen
speednumber | nullcontextopen
coursenumber | nullcontextopen
destinationstring | nullcontextopen
straight_line_distance_minteger | null (m)valueopen
updated_atstring | nullcontextopen

Fetch this section

curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643?include=vessel_traffic"

# paginated, one section at a time
curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643/sections/vessel_traffic?limit=25"

Try it now

This is a real call against the public demo, from here. What appears below is what the API returned — not a sample.