Zum Inhalt
HALOWERK

Kartenwerk

tides

Returns tide predictions for a NOAA CO-OPS station: every high and low water in the window with its time and height above datum, the range between them, and which extreme comes next with the time remaining. Where the station also measures, the observed water level is fetched and compared with the prediction — wind and air pressure routinely push the real level away from the astronomical forecast, and that residual is the figure that matters for anyone near a limit, so it is returned rather.

POST https://karte.halowerk.com/v1/tides

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
stationstringNeinNOAA station id, e.g. 8454000. Either this or a coordinate.
latitudenumberNeinLatitude; the nearest station is used.
longitudenumberNeinLongitude.
daysintegerNeinHow many days of predictions.
datumstringNeinVertical datum heights are given against.
unitsstringNeinmetric = metres, english = feet.
include_observedbooleanNeinAlso fetch the measured level and compare it with the prediction.
max_station_distance_kmnumberNeinRefuse a coordinate whose nearest station is further away than this.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "station": {
      "type": "string",
      "maxLength": 20,
      "description": "NOAA station id, e.g. 8454000. Either this or a coordinate."
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude; the nearest station is used."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "default": 2,
      "description": "How many days of predictions."
    },
    "datum": {
      "type": "string",
      "enum": [
        "MLLW",
        "MSL",
        "MHW",
        "NAVD"
      ],
      "default": "MLLW",
      "description": "Vertical datum heights are given against."
    },
    "units": {
      "type": "string",
      "enum": [
        "metric",
        "english"
      ],
      "default": "metric",
      "description": "metric = metres, english = feet."
    },
    "include_observed": {
      "type": "boolean",
      "default": true,
      "description": "Also fetch the measured level and compare it with the prediction."
    },
    "max_station_distance_km": {
      "type": "number",
      "minimum": 1,
      "maximum": 500,
      "default": 100,
      "description": "Refuse a coordinate whose nearest station is further away than this."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "days": 2,
  "datum": "MLLW",
  "units": "metric",
  "include_observed": true,
  "max_station_distance_km": 100
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →