Weather Warnings API
The meteoblue Weather Warnings API is in Beta phase. Major breaking changes to the API are not expected.
Warnings API
Please note, that our Warnings API has a different endpoint URL and can not combined with forecast or history packages.
The Warnings API delivers CAP (Common Alerting Protocol) weather warnings issued by national authorities such as national weather services. The API provides the warning for the selected coordinate along with the whole warning area, the official warning text and classification information. Warnings are globally available, given that the national authorities issue them in the standardised CAP format.
meteoblue is not responsible for the third-party data and content of the severe weather warnings it republishes.
Further information can be found in CAP 1.2, and a list of issuing organizations can be found on the website of the Severe Weather Information Centre.
The current weather warnings also can be visualised in our Weather Maps.
API URLs
Example weather warnings will not always be available or active in the URLs below. Please note, that the API will return {"results_count":0,"results":[]} if there is no current weather alert for the specified location.
Location specific weather warnings
Example URL:
https://my.meteoblue.com/warnings/list?apikey=DEMOKEY&lat=47.558&lon=7.573
OpenAPI documentation: warnings/list
This API call returns coordinate specific weather warnings, updated every 15 minutes. It checks for weather warnings in the surroundings (0.075 degrees).
Mandatory Parameters
Parameter | Description | Example |
---|---|---|
lat | Latitude coordinate in WGS84 | &lat=47.558 |
lon | Longitude coordinate in WGS84 | &lon=7.573 |
apikey | Personal API key | &apikey=DEMOKEY |
Complete information for a specific weather warning
Example URL:
https://my.meteoblue.com/warnings/select/WARNING_ID?apikey=YOURAPIKEY
OpenAPI documentation: warnings/select/warning_id
This API call delivers the complete information for a specific weather warning, by replacing "WARNING_ID" with the weather warning ID in the URL.
Mandatory Parameters
Parameter | Description | Example |
---|---|---|
WarningID | ID of a specific warning | 4761702 |
apikey | Personal API key | &apikey=DEMOKEY |
List of available authorities
Example URL:
https://my.meteoblue.com/warnings/feeds?apikey=DEMOKEY
OpenAPI documentation: warnings/feeds
This API call returns a list of all currently available authorities that are included in our Warnings API database. It also delivers all available information about the authorities and the most recently issued warnings.
Mandatory Parameters
Parameter | Description | Example |
---|---|---|
apikey | Personal API key | &apikey=DEMOKEY |
API Output
Warning categories
Parameter | Description | Example |
---|---|---|
TYPE_WIND | Wind | "Wind" |
TYPE_SNOW | Snow | "Snow" |
TYPE_THUNDERSTORM | Thunderstorm | "Thunderstorm" |
TYPE_VISIBILITY | Low visibility including Fog/Dust Storm, ... | "LowVis" |
TYPE_HEAT | Heat | "Heat" |
TYPE_COLD | Cold including Low Temperature, Icing on roads, ... | "Cold" |
TYPE_COASTAL | Coastal, anything happening at sea | "Coastal" |
TYPE_FIRE | Forestfires | "Forestfires" |
TYPE_AVALANCHES | Avalances | "Avalances" |
TYPE_RAIN | Rain | "Rain" |
TYPE_FLOOD | Flood | "Flood" |
TYPE_HAIL | Hail | "Hail" |
TYPE_GEOLOGICAL | Geological including Landslide, Mudslide, ... | "Geological" |
TYPE_AIR_QUALITY | Air Quality | "AirQuality" |
TYPE_VOLCANIC | Volcanic | "Volcanic" |
TYPE_EARTHQUAKE | Earthquake | "Earthquake" |
API Output example
An example for the output of a specific warning is shown below:
status "Actual"
response_types
0 "Monitor"
references null
hash "0618dc8e3b9279a340cc72084a7ff0e49a556cffd1b65b2d10750bf9148eb4ab_0"
message_type "Update"
urgency "Future"
incidents null
cap_urls
0 "https://feeds.meteoalarm.org/api/v1/warnings/feeds-italy/165cc0fc-c5bb-4609-85ab-c15d6e5cd020"
source null
severity "Severe"
authority_id "it-meteoam"
errors
0 "Reference for an Alert Update/Cancel is unproperly formated"
scope "Public"
certainty "Likely"
id 4761702
updated_at "2023-03-27T21:40:44"
starts "2023-03-27T22:00:00"
restriction null
effective "2023-03-27T22:00:00"
message_id "2.49.0.0.380.3.IT.230326113349.123"
ingested_at "2023-03-27T21:40:44"
types
0 "Wind"
addresses null
onset "2023-03-27T22:00:00"
sender_id "[email protected]"
has_errors 1
code []
expires "2023-03-28T21:59:00"
sent "2023-03-26T09:33:51"
categories
0 "Met"
note null
country
coordinates
type "Point"
coordinates
0 12.12715693938964
1 42.64998614632276
name "Italy"
dept "Italy: Centro Nazionale di Meteorologia e Climatologia Aeronautica (CNMCA)"
url "http://www.meteoam.it/"
logo "it-meteoam-it.png"
areas
0
type "Polygon"
coordinates
0
0
0 16.869502
1 40.395403
1
0 16.905013
1 40.435273
2
0 16.998952
1 40.493672
3
0 17.071727
1 40.515197
4
0 17.115678
1 40.515923
5
0 17.14418
1 40.507483
6
0 17.137715
1 40.449913
7
0 17.200533
1 40.408122
8
0 17.498007
1 40.292297
9
0 17.676529
1 40.299936
10
0 17.83309
1 40.281463
11
0 17.869335
1 40.26691
12
0 17.917261
1 40.226603
13
0 17.916285
1 40.187762
14
0 18.010152
1 40.105911
15
0 17.940192
1 40.045633
16
0 18.015768
1 40.032924
17
0 17.991914
1 39.99822
18
0 18.039378
1 39.933697
19
0 18.068268
1 39.909142
20
0 18.181881
1 39.845849
21
0 18.203588
1 39.835826
22
0 18.268788
1 39.83217
23
0 18.348476
1 39.786855
24
0 18.369382
1 39.792422
25
0 18.391943
1 39.817227
26
0 18.411552
1 39.97596
27
0 18.479302
1 40.0448
28
0 18.522324
1 40.105895
29
0 18.519262
1 40.136091
30
0 18.485348
1 40.170891
31
0 18.467636
1 40.223803
32
0 18.429851
1 40.289585
33
0 18.236855
1 40.452341
34
0 18.078807
1 40.540787
35
0 18.023415
1 40.643754
36
0 17.935548
1 40.687535
37
0 17.799383
1 40.71994
38
0 17.667851
1 40.779611
39
0 17.483507
1 40.83461
40
0 17.334924
1 40.945399
41
0 17.097524
1 41.070471
42
0 16.869288
1 41.143929
43
0 16.76808
1 41.164426
44
0 16.477096
1 41.261484
45
0 16.009071
1 41.433173
46
0 15.967556
1 41.455331
47
0 15.920911
1 41.503171
48
0 15.904539
1 41.536162
49
0 15.894635
1 41.575336
50
0 15.909216
1 41.617345
51
0 16.065969
1 41.691923
52
0 16.097631
1 41.720292
53
0 16.145111
1 41.741607
54
0 16.193703
1 41.776748
55
0 16.203347
1 41.824171
56
0 16.180244
1 41.853115
57
0 16.188139
1 41.88882
58
0 16.143812
1 41.914772
59
0 16.058269
1 41.950223
60
0 16.012402
1 41.950963
61
0 15.824783
1 41.92567
62
0 15.683761
1 41.917805
63
0 15.62908
1 41.930876
64
0 15.42393
1 41.903162
65
0 15.356974
1 41.905802
66
0 15.342341
1 41.918341
67
0 15.139328
1 41.928093
68
0 15.112208
1 41.825889
69
0 15.102248
1 41.741739
70
0 15.155497
1 41.706741
71
0 15.063463
1 41.657657
72
0 15.020413
1 41.623683
73
0 14.953413
1 41.646057
74
0 14.934881
1 41.533043
75
0 15.098699
1 41.420541
76
0 15.059987
1 41.359645
77
0 15.147402
1 41.284148
78
0 15.273359
1 41.257088
79
0 15.251327
1 41.197784
80
0 15.21446
1 41.161866
81
0 15.241373
1 41.134177
82
0 15.279348
1 41.102525
83
0 15.319688
1 41.091081
84
0 15.401487
1 41.101759
85
0 15.542462
1 41.05518
86
0 15.567888
1 41.093857
87
0 15.762732
1 41.089407
88
0 15.853365
1 41.132295
89
0 15.948132
1 41.106241
90
0 16.044657
1 41.032022
91
0 15.970213
1 40.96287
92
0 16.113375
1 40.900138
93
0 16.163482
1 40.931511
94
0 16.409721
1 40.700733
95
0 16.565768
1 40.763654
96
0 16.721815
1 40.712671
97
0 16.730405
1 40.473509
98
0 16.869502
1 40.395403
properties {}
info
0
id 7407606
language "en-GB"
audience "Private"
headline "Orange Wind Warning for Italy - Puglia"
instruction "BE PREPARED. Take precautions and keep up to date with the latest weather forecast. Expect some disruption to daily routines and BE PREPARED for disruption to outdoor activities."
contact null
alert_id 4761702
event "Orange Wind Warning"
sender_name "Italian Air Force National Meteorological Service"
description 'Severe weather expected\n (DISCLAIMER: "Information provided on METEOALARM for Italy regard only the intensity and recurrence of the phenomena, further details can be found at www.meteoam.it. METEOALARM information do not provide the assessment of impact on the territory and they do not represent the Official Alerts messages that are issued by the National Civil Protection Service https://www.protezionecivile.gov.it")'
web "http://meteoalarm.eu/en_UK/0/0/IT015-Puglia.html"
areas_description
0 "Puglia"
resources []
1
id 7407608
language "it-IT"
audience "Privato"
headline "Allerta Vento Arancione per l'Italia - Puglia"
instruction "ESSERE PREPARATI. Prendere le dovute precauzioni e tenersi aggiornati con le ultime previsioni del tempo. Aspettarsi qualche interruzione delle normali attività quotidiane ed essere pronti per interruzione delle attività all'aria aperta."
contact null
alert_id 4761702
event "Arancione Vento Allerta"
sender_name "Servizio Meteorologico dell'Aeronautica Militare"
description `Sono previsti fenomeni meteorologici intensi\n (DISCLAIMER: "Le informazioni fornite su METEOALARM per l'Italia riguardano esclusivamente l'intensita' e la ricorrenza dei fenomeni, maggiori dettagli sono disponibili su www.meteoam.it. Le informazioni METEOALARM non forniscono la valutazione di impatto sul territorio e non rappresentano i messaggi di Allerta Ufficiali che vengono emessi dal Servizio Nazionale di Protezione Civile https://www.protezionecivile.gov.it")`
web "http://meteoalarm.eu/it_IT/0/0/IT015-Puglia.html"
areas_description
0 "Puglia"
resources []