Opið JSON-viðmót

Flóð og fjara fyrir 50 hafnir · ókeypis · engin skráning

Viltu birta flóð og fjöru í þínu eigin kerfi? Hér eru gögnin á föstum slóðum sem breytast ekki þótt vefsíðunni sé breytt. Engin skráning, enginn lykill, engin takmörk — bara statískar JSON-skrár.

Slóðir

https://tide.is/api/v1/stations.jsonListi yfir allar hafnir með hnitum og slóðum.

https://tide.is/api/v1/tides/<id>.jsonFlóð og fjara fyrir eina höfn, alla spátímabilið — t.d. reykjavik, akureyri, isafjordur.

Svarið

Atburðir eru flokkaðir eftir dagsetningu, svo það þarf ekki að leita — flettu bara upp deginum sem þú vilt:

{
  "station": { "id": "reykjavik", "name": "Reykjavík", "measured": true, … },
  "data":    { "timezone": "UTC", "height_unit": "m", "to": "2028-12-31", … },
  "days": {
    "2027-09-16": [
      { "time": "00:30", "type": "low", "height": 0.46 },
      { "time": "06:32", "type": "high", "height": 3.85 }, …
    ], …
  }
}

Ísland er á UTC allt árið, svo "time" er íslenskur staðartími.

Dæmi

Flóð og fjara dagsins í dag:

// JavaScript
const r = await fetch("https://tide.is/api/v1/tides/reykjavik.json");
const d = await r.json();
const today = new Date().toISOString().slice(0, 10);
for (const e of d.days[today]) {
  console.log(e.time, e.type, e.height + " m");
}

# curl + jq
curl -s https://tide.is/api/v1/tides/reykjavik.json \
  | jq ".days[\"$(date -u +%F)\"]"

Skilmálar

Notkun er frjáls — einstaklingum og fyrirtækjum að kostnaðarlausu.
Getið heimildar — merkið gögnin „Sjávarfallagögn frá tide.is“ með tengli á tide.is. Frumgögnin koma frá Landhelgisgæslu Íslands og hana má líka nefna.
Sækið sparlega — gögnin breytast ekki innan dagsins — ein sókn á dag dugar. Vinsamlegast afritið skrána í ykkar kerfi frekar en að sækja hana við hverja síðuskoðun.
Engin ábyrgð — þetta er stjarnfræðileg spá; veður og vindur breyta raunverulegri sjávarstöðu. Ekki ætlað til siglinga.

Stöðugleiki

Slóðirnar breytast ekki og auðkenni hafna (reykjavik, akureyri …) haldast óbreytt. Reitum getur fjölgað en engir hverfa.

Spáin nær núna til 2028-12-31 — sjáið data.to í hverri skrá. Þegar ný gögn berast lengist tímabilið einfaldlega: fleiri dagar bætast í days. Ekkert annað breytist, svo kerfi sem lesa viðmótið halda áfram að virka óbreytt.

Spurningar eða vantar eitthvað?

Vantar þig annað snið, önnur gögn (sólargang, tunglstöðu) eða fleiri staði? Sendu línu hér — gott að heyra hvað fólk er að smíða.