Zum Inhalt
HALOWERK

Naturwerk

earthquake brief

Returns a single earthquake in decision-ready form, either by its USGS event identifier or as the most significant event matching a search. Magnitude is reported with the magnitude type, because moment magnitude and local magnitude are not interchangeable at the edges of their ranges. Depth and, when a reference point is supplied, distance from it are given equal standing with magnitude, since a magnitude six at three hundred kilometres depth is harmless and a magnitude four and a half at.

POST https://natur.halowerk.com/v1/earthquake-brief

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
event_idstringNeinUSGS event id, e.g. us7000abcd. Without it the strongest recent event matching the filters is returned.
min_magnitudenumberNeinUsed only when no event_id is given.
hoursintegerNeinSearch window when no event_id is given.
reference_latnumberNeinYour location, to get distance and bearing.
reference_lonnumberNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "event_id": {
      "type": "string",
      "maxLength": 40,
      "description": "USGS event id, e.g. us7000abcd. Without it the strongest recent event matching the filters is returned."
    },
    "min_magnitude": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "default": 5,
      "description": "Used only when no event_id is given."
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 720,
      "default": 24,
      "description": "Search window when no event_id is given."
    },
    "reference_lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Your location, to get distance and bearing."
    },
    "reference_lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "min_magnitude": 5,
  "hours": 24,
  "reference_lat": 52.52,
  "reference_lon": 13.405
}

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 →