{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"hazard.schema.json","title":"Natural hazard event or official weather or tsunami warning (USGS, NASA EONET, Copernicus EMS, DWD, ECCC, NOAA tsunami warning centres)","description":"Sources: USGS earthquake feeds (US federal work, public domain); NASA EONET natural events curated from US federal upstream sources (public domain); Copernicus Emergency Management Service Rapid Mapping activations (free, full and open access under Regulation (EU) 2021/696, source acknowledgement required); DWD CAP weather warnings for Germany (CC BY 4.0, source: Deutscher Wetterdienst); ECCC CAP weather alerts for Canada (ECCC Data Servers End-use Licence, source: Environment and Climate Change Canada, alert content not altered); NOAA NTWC and PTWC tsunami bulletins (US federal work, public domain). Factual fields only. Refreshed daily, not real time.","type":"object","required":["id","authority","hazard_type","level","title","countries","start","updated","url","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"USGS- plus the USGS event ID, the EONET event ID (EONET_...), the CEMS activation code (EMSR...), DWD- plus the CAP identifier, ECCC- plus the CAP identifier, or TSUNAMI- plus the warning centre and event ID"},"authority":{"type":"string","description":"Public body that published the event"},"hazard_type":{"enum":["earthquake","tropical-cyclone","flood","wildfire","volcano","drought","severe-weather","landslide","tsunami","sea-ice","snow","dust-haze","extreme-temperature","quarry-blast","explosion","thunderstorm","wind","rain","fog","ice","other"],"description":"Normalised hazard type"},"level":{"enum":["green","yellow","orange","red",null],"description":"Normalised alert level (green lowest, red highest) where the source publishes one (USGS PAGER, ECCC alert colour) or derived from the CAP severity (DWD: Minor yellow, Moderate orange, Severe and Extreme red) or the tsunami bulletin category (Information green, Watch yellow, Advisory or Threat orange, Warning red); null when the source gives no alert level"},"source_level":{"type":["string","null"],"description":"Alert level as published by the source, for example PAGER orange"},"magnitude":{"type":["number","null"],"description":"Magnitude as published: earthquake magnitude, peak wind speed for tropical cyclones, burnt area for wildfires, iceberg area"},"magnitude_unit":{"type":["string","null"],"description":"Unit or scale of the magnitude, for example mww, mb, kts, acres, NM^2"},"title":{"type":"string","description":"Event title as published"},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"description":"ISO 3166-1 alpha-2 codes of the affected countries or territories as named by the source; empty for events at sea or when the source names no country"},"area":{"type":["string","null"],"description":"Area description as published (USGS place, EONET location, CEMS countries, CAP area names joined by semicolons and shortened after 25 names)"},"latitude":{"type":["number","null"],"minimum":-90,"maximum":90,"description":"Latitude of the epicentre, latest position or centroid (WGS 84)"},"longitude":{"type":["number","null"],"minimum":-180,"maximum":180,"description":"Longitude of the epicentre, latest position or centroid (WGS 84)"},"bbox":{"type":["array","null"],"items":{"type":"number"},"minItems":4,"maxItems":4,"description":"Bounding box [min_lon, min_lat, max_lon, max_lat] of the event's track or polygon, where the source gives more than one point"},"depth_km":{"type":["number","null"],"description":"Earthquake depth in kilometres (USGS)"},"tsunami":{"type":["boolean","null"],"description":"USGS tsunami flag: true when the event is in a region where tsunami information may be issued; not a tsunami warning"},"start":{"type":"string","description":"Start of the event (USGS origin time, first EONET observation, CEMS activation time), ISO 8601 in UTC; CEMS times are as published without a time zone"},"end":{"type":["string","null"],"description":"End of the event where published (EONET closed date)"},"expires":{"type":["string","null"],"description":"Expiry of a warning where published; records whose expiry has passed are dropped at publish time"},"updated":{"type":"string","description":"Last update by the source (USGS updated time, latest EONET observation, CEMS last update)"},"closed":{"type":["boolean","null"],"description":"True when the source has closed the event or activation (EONET, CEMS); null for earthquakes"},"event":{"type":["string","null"],"description":"Warning event as published (CAP event, for example frost or wind; tsunami bulletin category)"},"alert_type":{"type":["string","null"],"description":"ECCC alert type as published (warning, watch, advisory, statement)"},"severity":{"enum":["Extreme","Severe","Moderate","Minor","Unknown",null],"description":"CAP severity as published"},"urgency":{"enum":["Immediate","Expected","Future","Past","Unknown",null],"description":"CAP urgency as published"},"certainty":{"enum":["Observed","Likely","Possible","Unlikely","Unknown",null],"description":"CAP certainty as published"},"onset":{"type":["string","null"],"format":"date-time","description":"CAP onset of the warned conditions, ISO 8601 in UTC"},"area_codes":{"type":"array","items":{"type":"string"},"description":"Official area codes of the warning areas (DWD warn cell IDs, ECCC CLC codes); empty for other sources"},"area_code_type":{"type":["string","null"],"description":"Code system of area_codes, for example DWD warn cell ID or ECCC CLC"},"upstream_sources":{"type":"array","items":{"type":"string"},"description":"EONET upstream source IDs (US federal publishers, for example IRWIN, JTWC, NOAA_NHC, NATICE)"},"url":{"type":"string","description":"Official page for the event (USGS event page, upstream publisher page, CEMS activation page)"},"verification":{"const":"official-publication"},"paid_placement":{"const":false},"source_id":{"enum":["usgs-earthquake-feeds","nasa-eonet-events","copernicus-ems-rapid-mapping","dwd-cap-warnings","eccc-cap-alerts","noaa-tsunami-warnings"]},"source_url":{"type":"string"},"retrieved_at":{"type":"string"}}}