diff --git a/doc/metalerts/CAP-profile.md b/doc/metalerts/CAP-profile.md new file mode 100644 index 0000000..95978eb --- /dev/null +++ b/doc/metalerts/CAP-profile.md @@ -0,0 +1,632 @@ +The profile is fully CAP 1.2. (http://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html) compatible. + + +## CAP Elements + +Following defines how each element is used in the profile. + +### `` +Mandatory + +One alert message, specifying CAP OASIS standard with xml namespace. +The `` segment contains one individual warning for one area. For the same warning in different +languages different `` segments have to be specified. + +CAP warnings from MET contain one Norwegian and one English info block. +The following elements are identical in the info blocks for both languages: + + + + + ​​ + + ​​ + ​ + + + + +Some elements, like `` and `` are language dependent + +### `` +Mandatory + +Unique string, in time and space, for an alert message identifying the message/document. +MET constructs the identifier in one of the following ways: + + + + WMO​ ​organisation​ ​ID.YYMMDDHHMMSS.​WARNINGID + WMO​ ​organisation​ ​ID.YYYYMMDDHHMMSS.​WARNINGID + + + +- WMO organization ID for CAP alerts issued by MET Norway is ​2.49.0.1.578.0 +- YYYYMMDDHHMMSS​ ​is​ ​the​ ​UTC​ ​time​ ​of​ ​issue. +- WARNINGID​ ​is​ ​an​ ​internal​ ​identifier + + Example:​ + + + + 2.49.0.1.578.0.20230724084526.007 + + + + + + The identfier should not be used to convey/extract information about the message except the identity of the message. + +### `` +Mandatory + +Email address of sender, noreply@met.no + +Example + + + + noreply@met.no + + + + + +### `` +Mandatory + +The time the message was produced. (UTC) +Follows OASIS standard + +Example + + + + 2023-07-16T09:49:16+00:00 + + + + +### `` +Mandatory + +`Actual` for real messages, `Test` for test messages. + +### `` +Mandatory + +`Alert` for a new message, `Update` to update one or more messages, `Cancel`to cancel one or more messages. +`Update` and `Cancel` must always include a reference element, denoting which messages are updated/cancellled. + +### `` +Not used + +### `` +Mandatory + +Always `Public` + +### `` +Not used + +### `` +Mandatory + +Identifies the message as following MET/NVE CAP-profile + +Example: + `CAP-V12.NO.V1.0` + +### `` +Not used + +### `` +Mandatory for Update and Cancel messages. +Not allowed for msgType Alert + +The​ ​extended​ ​message​ ​identifier(s)​ ​(in​ ​the​ ​form​​ ​sender,identifier,sent)​ ​of +an​ ​earlier​ ​CAP​ ​message​ ​or​ ​messages​ ​referenced​ ​by​ ​this​ ​one. + +Example: + + + + noreply@met.no,2.49.0.1.578.0.20230727070844.041,2023-07-27T07:35:28+00:00 + + + + +### `` +Optional + +Used​ ​to​ ​collate​ ​multiple​ ​messages​ ​referring​ ​to​ ​different​ ​aspects​ ​of​ ​the same​ ​incident + +Used for a spesific weather incident, for example a spesific storm/extreme weather incident + +Example: + + + + 0000050690 + + + + +### `` +Mandatory + +Only a single info container pr. language. So, if multiple info containers, it is exact same information translated into multiple languages. +Each info container gives a warning for one area in one language. + +#### `` +Mandatory + +Language for this info-element MET uses `no` and `en-GB` + +Example: + + + no + + + + +#### `` +Mandatory + +Always `Met` + +Example: + + + + + Met + + + + +#### `` + +Text denoting type of event + +MET are currently (July 2023) using the following events. + +11 totalt + +| Norwegian | English | +| ---------- | --------| +| Vindkast | Vindkast | +| Kuling | Gale | +| Regn | Rain | +| Snø | Snow | +| Styrtregn| Rain flood| +| Snøfokk| Blowing snow | +| Vannstand langs kysten og i fjordene| Water level at the coast and in the fjords | +| Polart ​lavtrykk| Polar low | +| Skogbrannfare| Forest fire danger | +| Ising| Icing | +| Mye lyn| Lightning | +| Is | Ice | + +#### `` + +Mandatory + +MET use `Monitor`, except when downgrading warnings. In this case `AllClear` is used with msgType `Update`. +`Cancel` message have responseType `None` + + +#### `` + +Mandatory + +MET normally use `Future` + +#### `` +Mandatory + +`Extreme`, `Severe`, `Moderate` or `Minor`. +Minor is only used for downgrade and Cancel warnings. + +#### `` +Mandatory + +`Observed`,​ ​`Likely` or `Possible` + + + +#### `` +Not used + +#### `` + +Mandatory `eventCode` with valueName `eventType`. + +MET uses the following event types: +- wind +- gale +- rain +- snow +- ice +- rainFlood +- blowingSnow +- stormSurge +- polarLow +- forestFire +- icing +- lightning + + +Example: + + + + + + eventType + rainFlood + + + + + + +#### `` + +Mandatory + +The effective time of the information of the alert message. +For messages from MET this is always the same as `` + + +#### `` + +Mandatory + +The expected time of the beginning of the subject event of the alert message + +#### `` + +Mandatory + +The alert is valid until expired or cancelled, NOT denoting the time when the weather is getting better. + +#### `` + +Mandatory + +The human-readable name of the agency or authority issuing this alert. + +Meteorologisk Institutt/MET Norway + +Example: + + + + Meteorologisk Institutt + + + + +#### `` + +Mandatory + +Short summary of the entire message, giving info about event type, awareness level (color) , area and valid time. + +Example: + + + + + Forest fire danger, yellow level, Parts of Troms and Nordland, 2023-07-28T00:00:00+00:00, 2023-08-06T00:00:00+00:00 + + + + + +#### `` + +Mandatory + +An extended human readable description of the hazard or event that occasioned this message. + +Example: + + + + Local forest fire danger until significant precipitation + + + + +#### `` + +Mandatory + +Recommended actions + +Example: + + + + Be careful with open fire. Follow the instructions from the local authorities. Emergency services should assess a necessary level of alertness. + + + + + +#### `` +Mandatory + +Link to additional​ ​or reference​ ​information​ ​regarding​ ​this​ ​alert + +Example: + + + + https://www.met.no/vaer-og-klima/ekstremvaervarsler-og-andre-farevarsler/vaerfenomener-som-kan-gi-farevarsel-fra-met/styrtregn + + + + +#### `` +Mandatory + +Url to a contact information. +Example: + + + + https://www.met.no/kontakt-oss + + + + +#### `` +The following parameters are mandatory: +- **awareness_level:** Awareness level, including color. Used by Meteoalarm +- **awareness_type:** Type of phenomena, according the Meteoalarm classification + +The following parameters are optional +- **incidentName:** Name of the weather incident (Only used for extreme weather alerts): +- **geographicDomain:** Type of area (marine, land) +- **triggerLevel:** Observed weather will exceed the value specified here​ ​during​ ​the​ ​indicated time period and area. +- **evendEndingTime:** The expected end time of the subject event in the alert message. This is the time at +which the hazard conditions of the subject event are no longer expected. This is the counterpart to the +`` element. +- **consequences:** Consequences of the forecasted weather (related to instructions) +- **awarenessResponse:** Text describing recommended action/awareness (dependent on severity/certainty) +- **awarenessSeriousness:** Text describing seriousness f the situation (dependent on severity/certainty) +- **eventAwarenessName:** Name given severity, certainty and eventType + +Additional parameter may be used. + +Example forest-fire danger, no eventEndingTime, since the end time is uknown. + + + + + + + consequences + Vegetation is very easily ignited and very large areas may be affected. + + + eventAwarenessName + High forest fire danger + + + awareness_level + 3; orange; Severe + + + awarenessSeriousness + Severe situation + + + awareness_type + 8; forest-fire + + + awarenessResponse + Be prepared + + + geographicDomain + land + + + + + + +Extreme weather Gyda, expected to end at January 13th 2022. + + + + + + eventEndingTime + 2022-01-13T20:00:00+00:00 + + + consequences + Risk of flooding of low-lying densely populated areas. Check varsom.no for more information. Locally difficult driving conditions, especially at waterways. Roads can be closed. Many journeys will have longer travel time. Road conditions affected with road spray and hydroplaning in a few places. Some places may temporarily lose the road connection, often several days. Buildings and structures can collapse as a result of the rainfall. Danger to life in fast flowing/deep water. Danger of long power outages. + + + eventAwarenessName + Extremely heavy rain ongoing + + + awareness_level + 4; red; Extreme + + + awarenessSeriousness + Extreme situation + + + awareness_type + 10; rain + + + triggerLevel + 20 mm/12t + + + awarenessResponse + Take action + + + incidentName + Gyda + + + geographicDomain + land + + + + + +#### `` +Optional + +Refers​ ​to​ ​an​ ​additional​ ​file​ ​with​ ​supplemental​ ​information​ ​related​ ​to​ ​this +``​ ​element;​ ​e.g.,​ ​an​ ​image​ ​or​ ​audio​ ​file. +At MET this is typically used to link to a png file with an illustration of the warning (often a map of the affected area). + +##### `` +Required in the `` element + +Text describing the resource + +##### `` +Required in the `` element + +MIME content type and subtype of the resource +##### `` +Required in the `` element + +Hyperlink to the resource file + + +Example of the resource element + + + + + Kart over Stor skogbrannfare, oransje nivå, Deler av Troms, 2023-07-31T09:00:00+00:00, 2023-08-21T22:00:00+00:00 + image/png + https://slaps.met.no/cap-images/1ddf98a8-4df1-40dd-bace-5a7ec720d529.png + + + + + + +#### `` +Mandatory + +The​ `​`​ ​segment​ ​describes​ ​a​ ​geographic​ ​area​ ​to​ ​which​ ​the​ `​`​ ​segment +in​ ​which​ ​it​ ​appears​ ​applies.​ ​ MET uses only one area block for each info block and​ ​an​ ​altitude​ ​or​ ​altitude​ ​range,​ ​expressed​ ​in​ ​standard +latitude​ ​/​ ​longitude​ ​/​ ​altitude​ ​terms​ ​in​ ​accordance​ ​with​ ​a​ ​specified​ ​geospatial datum. + +##### `` +Mandatory + +Text describing the area + +##### `` +Mandatory + +The paired values of points defining a polygon that delineates the affected area of hte alert message. + +(1)​ ​Code​ ​Values: The​ ​geographic​ ​polygon​ ​is​ ​represented​ ​by​ ​a +whitespace-delimited​ ​list​ ​of​ ​[WGS​ ​84]​​ ​coordinate​ ​pairs.​ ​ ​(See​ ​WGS​ ​84​ ​Note​ ​at +end​ ​of​ ​this​ ​section) +(2)​ ​A​ ​minimum​ ​of​ ​4​ ​coordinate​ ​pairs​ ​MUST​ ​be​ ​present​ ​and​ ​the​ ​first​ ​and​ ​last +pairs​ ​of​ ​coordinates​ ​MUST​ ​be​ ​the​ ​same. +(3)​ ​Multiple​ ​instances​ ​MAY​ ​occur​ ​within​ ​an​ `​`​ ​block. + + +Coastlines and country borders should be followed as accurately as possible. However, polygons may extend country borders although alerts are only valid in the issuing country. + +Resolution of the polygons should be defined conservatively reducing number of points so that the polygons can be processed in a reasonable time. + +##### `` +Optional + +Code to describe the norwegian administrative areas affected by the warning, MET use "county" and "MunicipalityID". + +##### `` +Not used + +##### `` +Optional + +Minimum altitude of the affected area of the alert message (in feet above mean sea level) + + +##### `` +Optional + +Maximum altitude of the affected area of the alert message (in feet above mean sea level) + + +Example: + + + + + + Parts of S-Norway + 61.5329,5.24557 60.3308,5.64294 59.2396,6.24904 58.2631,6.33293 57.9566,7.26079 58.0995,8.37604 58.5239,9.05849 59.0371,9.74866 59.3151,10.1703 59.6916,10.6379 59.9564,11.0743 60.5819,11.7377 61.3107,13.0594 61.8388,12.1671 63.0558,12.2677 63.3914,11.4368 62.7406,9.02713 62.2523,7.11171 62.1304,6.41532 61.8829,5.6736 61.5329,5.24557 61.5329,5.24557 + + county + 46 + + + county + 11 + + + county + 15 + + + county + 42 + + + county + 38 + + + county + 34 + + + county + 50 + + + county + 03 + + + county + 30 + + + MunicipalityId + 0301;1108;1111;1112;1114;1122;1133;1134;1135;1506;1525;1539;1563;1577;1578;3005;3006;3007;3020;3022;3023;3024;3025;3029;3030;3031;3032;3033;3034;3035;3036;3037;3038;3039;3040;3041;3042;3043;3044;3045;3046;3047;3048;3049;3050;3051;3052;3053;3054;3403;3405;3407;3411;3412;3413;3414;3419;3420;3421;3422;3423;3424;3425;3426;3427;3428;3429;3430;3431;3432;3433;3434;3435;3436;3437;3438;3439;3440;3441;3442;3443;3446;3447;3448;3449;3450;3451;3452;3453;3454;3802;3803;3804;3805;3806;3807;3808;3812;3813;3814;3815;3816;3817;3818;3819;3820;3821;3822;3823;3824;3825;4201;4202;4203;4204;4205;4206;4207;4211;4212;4213;4214;4215;4216;4217;4218;4219;4220;4221;4222;4223;4224;4225;4226;4227;4228;4602;4611;4617;4618;4619;4620;4621;4622;4623;4624;4628;4629;4630;4631;4634;4635;4637;4638;4639;4640;4641;4642;4643;4644;4645;4646;4647;4648;4649;4650;4651;5021;5022;5025;5026;5027;5028;5032;5033;5034 + + 0 + 9000 + + + + diff --git a/doc/metalerts/CAP-v3-profile.md b/doc/metalerts/CAP-v3-profile.md new file mode 100644 index 0000000..86c358d --- /dev/null +++ b/doc/metalerts/CAP-v3-profile.md @@ -0,0 +1,697 @@ +--- +title: metalerts/2.0 cap profile +date: 2023-11-27 +author: Helen Korsmo +layout: page +summary: > + Description of the CAP profile used in metalerts/2.0 +--- + + + +The profile is fully [Oasis CAP 1.2](http://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html) compatible. +It it also compliant with https://git.smhi.se/metcoop/metcoop-cap-profile/blob/master/metcoop-cap-profile.md + + +Time formats for the sent, effective, onset and expires elements follows the Oasis CAP 1.2/iso 8601 standard. + +## CAP Elements + +Following defines how each element is used in the profile. + +### `` +Oasis: Mandatory + +One alert message, specifying CAP OASIS standard with xml namespace. +The `` segment contains one individual warning for one area. For the same warning in different +languages different `` segments have to be specified. + +CAP warnings from MET contain one Norwegian and one English info block. +The following elements are identical in the info blocks for both languages: + + + + + + + + + + + + +Some elements, like `` and `` are language dependent + +### `` +Oasis: Mandatory + +Unique string, in time and space, for an alert message identifying the message/document. +MET constructs the identifier the following way: + + + + WMO organisation ID.YYYYMMDDHHMMSS.WARNINGID + + + +- WMO organization ID for CAP alerts issued by MET Norway is 2.49.0.1.578.0 +- YYYYMMDDHHMMSS is the UTC time of issue. +- WARNINGID is an internal identifier + + Example: + + + + 2.49.0.1.578.0.20230724084526.007 + + + + + + The identifier should not be used to convey/extract information about the message except the identity of the message. + +### `` +Oasis: Mandatory + +Format: WMO Organization ID (OID) with urn:oid: prefix. + + + + urn:oid:2.49.0.0.578.0 + + + + +### `` +Oasis: Mandatory + +The time the message was produced (UTC). +Follows the iso 8601 standard + +Example + + + + 2023-07-16T09:49:16+00:00 + + + + +### `` +Oasis: Mandatory + +`Actual` for real messages, `Test` for test messages. + +### `` +Oasis: Mandatory + +`Alert` for a new message, `Update` to update one or more messages, `Cancel` to cancel one or more messages. +`Update` and `Cancel` must always include a reference element, denoting which messages are updated/cancellled. + +### `` +Not used + +### `` +Oasis: Mandatory + +Always `Public` + +### `` +Not used + +## `code` +Oasis: Optional +MetCoOp: Mandatory + +Identifies the message as following MetCoOP CAP Standard, versioned. + +Format: Link to the versioned specification document starting with profile:cap:. Profile specification is maintained in MetCoOp git repository in https://git.smhi.se/metcoop/metcoop-cap-profile. + +Example: `profile:cap:https://git.smhi.se/metcoop/metcoop-cap-profile/blob/version-1.0/metcoop-cap-profile.md` + +### `` +Not used + +### `` +Oasis: Mandatory for Update and Cancel messages. +Not allowed for msgType Alert, + +The extended message identifier(s) (in the form sender,identifier,sent) of +an earlier CAP message or messages referenced by this one. + +Example: + + + + + urn:oid:2.49.0.0.578.0,2.49.0.1.578.0.20230707073744.015,2023-07-07T07:41:23+00:00 urn:oid:2.49.0.0.578.0,2.49.0.1.578.0.20230630062115.065,2023-06-30T06:24:06+00:00 urn:oid:2.49.0.0.578.0,2.49.0.1.578.0.20230621114131.059,2023-06-21T11:41:45+00:00 urn:oid:2.49.0.0.578.0,2.49.0.1.578.0.20230621103238.011,2023-06-21T10:33:11+00:00 urn:oid:2.49.0.0.578.0,2.49.0.1.578.0.20230621075106.074,2023-06-21T07:51:19+00:00 urn:oid:2.49.0.0.578.0,2.49.0.1.578.0.20230615123705.088,2023-06-21T07:18:03+00:00 + + + + + +UPDATE and CANCEL msgTypes refers to all previous still valid messages that it updates (excluding already expired messages). + +### `` +Optional + +Used to collate multiple messages referring to different aspects of the same incident + +Used for a spesific weather incident, for example a spesific storm/extreme weather incident + +Example: + + + + 0000050690 + + + + +### `` +Oasis: Optional +MetCoOp: Mandatory + +Only a single info container pr. language. So, if multiple info containers, it is exact same information translated into multiple languages. +Each info container gives a warning for one area in one language. + +#### `` +Oasis: Optional +MetCoOp: Mandatory + +Language for this info-element. MET uses `no` and `en-GB` + +Example: + + + + no + + + + +#### `` +Oasis: Mandatory + +MET always use `Met`. +Other categories are used as appropriate + +Example: + + + + + Met + Fire + + + + +#### `` +Oasis: Mandatory + +Text denoting type of event + +MET are currently (July 2023) using the following events. + +11 totalt + +| Norwegian | English | +| ---------- | --------| +| Vindkast | Wind gust | +| Kuling | Gale | +| Regn | Rain | +| Snø | Snow | +| Styrtregn| Rain flood| +| Snøfokk| Blowing snow | +| Vannstand langs kysten og i fjordene| Water level at the coast and in the fjords | +| Polart lavtrykk| Polar low | +| Skogbrannfare| Forest fire danger | +| Ising| Icing | +| Mye lyn| Lightning | +| Is | Ice | + + +#### `` + +Oasis: Optional +MetCoOp: Mandatory + +MET use `Monitor`, except when downgrading warnings. In this case `AllClear` is used with msgType `Update`. +`Cancel` message have responseType `None` + +#### `` + +Oasis: Mandatory + +MET normally use `Future` + +#### `` +Oasis: Mandatory + +`Extreme`, `Severe`, `Moderate` or `Minor`. +Minor is only used for downgrade and Cancel warnings. + +#### `` +Oasis: Mandatory + +`Observed`,`Likely` or `Possible` + + +#### `` +Not used + +#### `` +Oasis: Optional +MetCoOp: Optional +MET/NVE: Mandatory `eventCode` with valueName `eventType`. +MET: Mandatory `eventCode` with valueName `OET:v1.0`` + +MET uses the following value for the eventType: +- wind +- gale +- rain +- snow +- ice +- rainFlood +- blowingSnow +- stormSurge +- polarLow +- forestFire +- icing +- lightning + + + +The values for the OET:v1.0 is as defined in OASIS eventCode list https://docs.oasis-open.org/emergency/etl/v1.0/etl-v1.0.html + + +Example: + + + + + + eventType + rainFlood + + + OET:v1.0 + OET-080 + + + + + +#### `` +MET/NVE: Optional +MET: Not used + +#### `` + +Oasis: Optional +MetCoOp: Mandatory + +The expected time of the beginning of the subject event of the alert message + +#### `` + +Oasis: Optional +MetCoOp: Optional +MET/NVE: Mandatory + + +The alert is valid until expired or cancelled, NOT denoting the time when the weather is getting better. + + +#### `` + +Oasis: Optional +MetCoOp: Mandatory + +The human-readable name of the agency or authority issuing this alert. + +Meteorologisk Institutt/MET Norway + +Example: + + + + Meteorologisk Institutt + + + + +#### `` + +Oasis: Optional +MetCoOp: Mandatory + +Short summary of the entire message, giving info about event type, awareness level (color) , area and valid time. + +Example: + + + + + Forest fire danger, yellow level, Parts of Troms and Nordland, 2023-07-28T00:00:00+00:00, 2023-08-06T00:00:00+00:00 + + + + + +#### `` + +Oasis: Optional +MetCoOp: Mandatory + +An extended human readable description of the hazard or event that occasioned this message. + +Example: + + + + Local forest fire danger until significant precipitation + + + + +#### `` +Oasis: Optional +MetCoOp: Optional +MET/NVE: Mandatory + +Recommended actions + +Example: + + + + Be careful with open fire. Follow the instructions from the local authorities. Emergency services should assess a necessary level of alertness. + + + + + +#### `` +Oasis: Optional +MetCoOp: Mandatory + +Link to additional or reference information regarding this alert + +Example: + + + + https://www.met.no/vaer-og-klima/ekstremvaervarsler-og-andre-farevarsler/vaerfenomener-som-kan-gi-farevarsel-fra-met/styrtregn + + + + +#### `` +Oasis: Optional +MetCoOp: Mandatory + +Url to a contact information. +Example: + + + + https://www.met.no/kontakt-oss + + + + +#### `` + +Oasis: Optional + +MetCoOp: The following parameter is mandatory: +- **riskMatrixcolor** Value of the risk matrix color, value one of('green', 'yellow','orange', 'red'). + +MET/NVE: The following parameters are mandatory: +- **consequences:** Consequences of the forecasted weather (related to instructions) +- **awarenessResponse:** Text describing recommended action/awareness (dependent on severity/certainty) +- **awarenessSeriousness:** Text describing seriousness f the situation (dependent on severity/certainty) +- **eventAwarenessName:** Name given severity, certainty and eventType +- **awareness_level:** Awareness level, including color. Used by Meteoalarm +- **awareness_type:** Type of phenomena, according the Meteoalarm classification + + +MET/NVE: The following parameters are mandatory in some circumstamces: +- **incidentName:** Name of the weather incident (Only used for extreme weather alerts) +- **evendEndingTime:** The expected end time of the subject event in the alert message. This is the time at +which the hazard conditions of the subject event are no longer expected. This is the counterpart to the +`` element. +- **administrativeId:** Administrative areas affected by the warning - denoted as `ISO-3166-2:iso-code` for example `ISO-3166-2:NO-54`. This means that all or parts of this county is inside the polygon in the area-element. +- **MunicipalityId:** Ids of Norwegian municipalities affected by the warning. + +MET/NVE: The following parameters are optional: + +- **geographicDomain:** Type of area (marine, land) +- **triggerLevel:** Observed weather will exceed the value specified here​ ​during​ ​the​ ​indicated time period and area. + + +Additional parameters may be used. + +Example forest-fire danger, no eventEndingTime, since the end time is uknown. + + + + + + + consequences + Vegetation is very easily ignited and very large areas may be affected. + + + eventAwarenessName + High forest fire danger + + + awareness_level + 3; orange; Severe + + + riskMatrixColor + orange + + + awarenessSeriousness + Severe situation + + + awareness_type + 8; forest-fire + + + awarenessResponse + Be prepared + + + geographicDomain + land + + + administrativeId + NO:county:46 + + + administrativeId + NO:municipalities:4601;4602;4611;4612;4613;4614;4615;4616;4617;4618;4619;4620;4621;4622;4623;4624;4625;4626;4627;4628;4629;4630;4631;4632;4633;4634;4635;4636;4637;4638;4639;4640;4641;4642;4643;4644;4645;4646;4647;4648;4649;4650;4651 + + + MunicipalityId + 4601;4602;4611;4612;4613;4614;4615;4616;4617;4618;4619;4620;4621;4622;4623;4624;4625;4626;4627;4628;4629;4630;4631;4632;4633;4634;4635;4636;4637;4638;4639;4640;4641;4642;4643;4644;4645;4646;4647;4648;4649;4650;4651 + + + + + + + +Extreme weather Gyda, expected to end at January 13th 2022. + + + + + + eventEndingTime + 2022-01-13T20:00:00+00:00 + + + consequences + Risk of flooding of low-lying densely populated areas. Check varsom.no for more information. Locally difficult driving conditions, especially at waterways. Roads can be closed. Many journeys will have longer travel time. Road conditions affected with road spray and hydroplaning in a few places. Some places may temporarily lose the road connection, often several days. Buildings and structures can collapse as a result of the rainfall. Danger to life in fast flowing/deep water. Danger of long power outages. + + + eventAwarenessName + Extremely heavy rain ongoing + + + awareness_level + 4; red; Extreme + + + riskMatrixColor + red + + + awarenessSeriousness + Extreme situation + + + awareness_type + 10; rain + + + triggerLevel + 20 mm/12t + + + awarenessResponse + Take action + + + incidentName + Gyda + + + geographicDomain + land + + parameter> + administrativeId + NO:county:46 + + + administrativeId + NO:municipalities:4601;4602;4611;4612;4613;4614;4615;4616;4617;4618;4619;4620;4621;4622;4623;4624;4625;4626;4627;4628;4629;4630;4631;4632;4633;4634;4635;4636;4637;4638;4639;4640;4641;4642;4643;4644;4645;4646;4647;4648;4649;4650;4651 + + + MunicipalityId + 4601;4602;4611;4612;4613;4614;4615;4616;4617;4618;4619;4620;4621;4622;4623;4624;4625;4626;4627;4628;4629;4630;4631;4632;4633;4634;4635;4636;4637;4638;4639;4640;4641;4642;4643;4644;4645;4646;4647;4648;4649;4650;4651 + + + + + + + + +#### `` +Oasis: Optional +MetCoOp: Optional +MET/NVE: Optional + +Refers​ ​to​ ​an​ ​additional​ ​file​ ​with​ ​supplemental​ ​information​ ​related​ ​to​ ​this +``​ ​element;​ ​e.g.,​ ​an​ ​image​ ​or​ ​audio​ ​file. +At MET this is typically used to link to a png file with an illustration of the warning (often a map of the affected area). + +##### `` +Oasis: Required in the `` element + +Text describing the resource + +##### `` +Oasis: Required in the `` element + +MIME content type and subtype of the resource +##### `` +Oasis: Required in the `` element + +Hyperlink to the resource file + + +Example of the resource element + + + + + Kart over Stor skogbrannfare, oransje nivå, Deler av Troms, 2023-07-31T09:00:00+00:00, 2023-08-21T22:00:00+00:00 + image/png + https://slaps.met.no/cap-images/1ddf98a8-4df1-40dd-bace-5a7ec720d529.png + + + + + + +#### `` +Oasis: Optional +MetCoOp: Mandatory + +The​ `​`​ ​segment​ ​describes​ ​a​ ​geographic​ ​area​ ​to​ ​which​ ​the​ `​`​ ​segment +in​ ​which​ ​it​ ​appears​ ​applies.​ ​ MET uses only one area block for each info block and​ ​an​ ​altitude​ ​or​ ​altitude​ ​range,​ ​expressed​ ​in​ ​standard +latitude​ ​/​ ​longitude​ ​/​ ​altitude​ ​terms​ ​in​ ​accordance​ ​with​ ​a​ ​specified​ ​geospatial datum. + +##### `` +Oasis: Mandatory + +Text describing the area + +##### `` +Oasis: Optional +MetCoOp: Mandatory + +The paired values of points defining a polygon that delineates the affected area of the alert message. + +(1)​ ​Code​ ​Values: The​ ​geographic​ ​polygon​ ​is​ ​represented​ ​by​ ​a +whitespace-delimited​ ​list​ ​of​ ​[WGS​ ​84]​​ ​coordinate​ ​pairs.​ ​ ​(See​ ​WGS​ ​84​ ​Note​ ​at +end​ ​of​ ​this​ ​section) +(2)​ ​A​ ​minimum​ ​of​ ​4​ ​coordinate​ ​pairs​ ​MUST​ ​be​ ​present​ ​and​ ​the​ ​first​ ​and​ ​last +pairs​ ​of​ ​coordinates​ ​MUST​ ​be​ ​the​ ​same. +(3)​ ​Multiple​ ​instances​ ​MAY​ ​occur​ ​within​ ​an​ `​`​ ​block. + + +Coastlines and country borders should be followed as accurately as possible. However, polygons may extend country borders although alerts are only valid in the issuing country. + +Resolution of the polygons should be defined conservatively reducing number of points so that the polygons can be processed in a reasonable time. + +##### `` +Oasis: Optional +MetCoOp: Optional +MET: not used + + +##### `` +Not used + +##### `` +Optional + +Minimum altitude of the affected area of the alert message (in feet above mean sea level) + + +##### `` +Optional + +Maximum altitude of the affected area of the alert message (in feet above mean sea level) + + +Example: + + + + + + Parts of S-Norway + 61.5329,5.24557 60.3308,5.64294 59.2396,6.24904 58.2631,6.33293 57.9566,7.26079 58.0995,8.37604 58.5239,9.05849 59.0371,9.74866 59.3151,10.1703 59.6916,10.6379 59.9564,11.0743 60.5819,11.7377 61.3107,13.0594 61.8388,12.1671 63.0558,12.2677 63.3914,11.4368 62.7406,9.02713 62.2523,7.11171 62.1304,6.41532 61.8829,5.6736 61.5329,5.24557 61.5329,5.24557 + + 0 + 9000 + + + + + +## Implementation notes +UPDATE and CANCEL events by the rules of https://developers.google.com/public-alerts/reference/cap-google + +### Update/Cancel practice as used at MET +- msgType `Cancel` is used to abort an alert message containing incorrect data (that was sent by mistake). Cancel messages will have `responseType=None`, `severity=Minor` and `expires` one hour after the `sent/onset` time. +The `references` element identifies the warning that was sent by mistake. +- We also send "AllClear" messages to indicate that the hazard conditions of the subject event in the referenced warnings are no longer expected. They will have `responseType=AllClear` `severity=Minor` and `expires` one hour after the `sent/onset` time. +The `references` element identifies the downgraded warning. + + +