Zum Inhalt
HALOWERK

Naturwerk

volcanic ash route

Takes a route as an ordered list of waypoints, samples it at a chosen spacing and tests every sample against the currently active SIGMETs carrying a volcanic ash hazard. For each hit you get the affected segment as a from-to pair of waypoints, the SIGMET issuing centre and flight information region, the validity window, the reported base and top of the ash layer, and the raw text. The distinction the response insists on is between intersection and proximity: where the source supplies a.

POST https://natur.halowerk.com/v1/volcanic-ash-route

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
waypointsarrayJaOrdered route points.
sample_kmnumberNeinSpacing at which the route is sampled.
cruise_level_ftintegerNeinIf given, SIGMETs whose layer does not include this level are reported separately as not affecting you.
proximity_kmnumberNeinDistance at which a point-only SIGMET counts as nearby.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "waypoints"
  ],
  "additionalProperties": false,
  "properties": {
    "waypoints": {
      "type": "array",
      "minItems": 2,
      "maxItems": 40,
      "description": "Ordered route points.",
      "items": {
        "type": "object",
        "required": [
          "lat",
          "lon"
        ],
        "additionalProperties": false,
        "properties": {
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          },
          "name": {
            "type": "string",
            "maxLength": 20
          }
        }
      }
    },
    "sample_km": {
      "type": "number",
      "minimum": 10,
      "maximum": 500,
      "default": 100,
      "description": "Spacing at which the route is sampled."
    },
    "cruise_level_ft": {
      "type": "integer",
      "minimum": 0,
      "maximum": 60000,
      "description": "If given, SIGMETs whose layer does not include this level are reported separately as not affecting you."
    },
    "proximity_km": {
      "type": "number",
      "minimum": 10,
      "maximum": 500,
      "default": 150,
      "description": "Distance at which a point-only SIGMET counts as nearby."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "waypoints": [
    {
      "lat": 64.1,
      "lon": -21.9,
      "name": "BIKF"
    },
    {
      "lat": 55.6,
      "lon": 12.6,
      "name": "EKCH"
    }
  ],
  "sample_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 →