Neptun·

← API reference

Harbour shelter

Wind shelter for 22,669 marinas — which direction a harbour is protected from.

GET /v1/shelter

Scope: levels

For every marina it is computed which compass directions are sheltered by land. That answers the question every evening ends with: will we lie quiet here in the forecast wind? Use protected_from to filter straight to the direction the wind is coming from.

Parameters

NameTypeDescription
bboxstring, optionalArea as minLat,minLon,maxLat,maxLon
latnumber, optionalLatitude (−90…90)
lonnumber, optionalLongitude (−180…180)
radiusnumber, optionalRadius in km (when using lat/lon)
protected_fromstring, optionalonly harbours sheltered from these directions (n,ne,e,se,s,sw,w,nw)
limitinteger, optionalmaximum number of results
offsetinteger, optionaloffset for paging

Example response

{ "ok": true, "harbours": [ { "name": "Maasholm", "lat": 54.68, "lon": 10.00,
    "protected_from": ["n","ne","e"], "score": 4 } ], "attribution": "…", "quota": { … } }