Public Weather API (PWA) - Voice (0.1)

Download OpenAPI specification:Download

Authentication

ApiKeyAuth

Security Scheme Type	API Key
Header parameter name:	x-api-key

mock

Mock endpoint for basic testing

Authorizations:

ApiKeyAuth

Responses

Get pollen forecast

Get voice text for pollen at ({latitude},{longitude}) named {location} using a specific pollen type {pollentype} or for all pollen types (no value)

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

location	string Example: location=München Name of the location, if it is not filled, we use our geolocation to get the closest city
pollentype	string or null [ 1 .. 8 ] characters ^[a-zA-Z]*$ Enum: "Ambrosia" "Beifuss" "Birke" "Erle" "Esche" "Graeser" "Hasel" "Roggen" Example: pollentype=Graeser Pollen type could be one of the following names - Ambrosia, Beifuss, Birke, Erle, Esche, Graeser, Hasel, Roggen

Responses

Response samples

200

Content type

application/json

{"releaseDate": "2022-06-28T09:00:00Z",
"nextUpdate": "2022-06-29T09:00:00Z",
"copyright": "Deutscher Wetterdienst - Medizin-Meteorologie",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"pollenType": "Graeser",
"items": [{"name": "Ambrosia",
"today": 3,
"tomorrow": 1,
"inTwoDays": 0
}
],
"text": [{"date": "2022-06-28T09:00:00Z",
"text": "Heute gibt es in München starke Pollenbelastung bei Gräsern."
}
]
}

Get pollen forecast

Get voice text for pollen at ({country},{zip_code}) named {location} using a specific pollen type {pollentype} or for all pollen types (no value)

Authorizations:

ApiKeyAuth

path Parameters

country required	string Example: DE Country code
zip_code required	string Example: 80807 ZIP Code with trailing zeros

query Parameters

location	string Example: location=München Name of the location, if it is not filled, we use mapping based on provided ZIP code
pollentype	string or null [ 1 .. 8 ] characters ^[a-zA-Z]*$ Example: pollentype=Erle Pollen type could be one of the following names - Ambrosia, Beifuss, Birke, Erle, Esche, Gräser, Hasel, Roggen

Responses

Response samples

200

Content type

application/json

{"releaseDate": "2022-06-28T09:00:00Z",
"copyright": "Wetter.com GmbH",
"pollenType": "Erle",
"pollen": {"data": [{"date": "2023-01-01",
"dayID_day": "Am Montag",
"dayID_option": "Heute",
"location": "Muenchen",
"text_long": "<DayID> herrscht in <Location> schwacher Pollenflug bei Hasel.",
"text_short": "<DayID> herrscht schwacher Pollenflug bei Hasel."
}
]
}
}

Get precipitation risk

Get voice precipitation forecast for ({latitude},{longitude}) named {location} for the next hour

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

location

string

Example: location=München

Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"run": "2022-06-29T13:25:00Z",
"source": "Hood",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"items": [{"date": "2022-06-29T13:30:00Z",
"value": 1
}
],
"text": "Bis 15:25 ist in München keinen Niederschlag in Sicht."
}

Get forecast next three hours information

Get voice forecast for next three hours for ({latitude},{longitude}) named {location}

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

location

string

Example: location=München

Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"forecastDate": "2022-06-29T07:06:08Z",
"nextUpdate": "2022-06-29T19:30:00Z",
"source": "w3Data",
"providerVersion": "prod-1.8.0",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"hourly": [{"date": "2022-06-28T22:00:00Z",
"weather": {"state": 2,
"text": "wolkig",
"icon": "n_2.svg"
},
"prec": {"sum": 0,
"probability": 0,
"sumAsRain": 0,
"class": 0
},
"temperature": {"avg": 18
},
"wind": {"unit": "km/h",
"direction": "Nordostwind",
"text": "NO",
"avg": 3,
"min": 3,
"max": 3,
"mean": 3,
"degree": 35,
"gusts": {"value": 10,
"text": ""
},
"significationWind": false
}
}
],
"text": "In München ist es die nächsten drei Stunden bewölkt und trocken. Die Temperaturen steigen von 14 auf 17 Grad."
}

Get forecast hourly information

Get voice forecast for a given hour {datetimefrom} for ({latitude},{longitude}) named {location}. The API returns all hours between {datetimefrom} and {datetimeto}, if the parameters are set. The hourly forecast horizon is for at most 72 hours.

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

datetimefrom	string 10 characters ^[0-9]*$ Example: datetimefrom=2022071410 Optional parameter to specify the forecast date - if it is not given, the actual hour is used
datetimeto	string 10 characters ^[0-9]*$ Example: datetimeto=2022071410 Optional parameter to specify the latest forecast date - if it is not given, the datetimefrom is used
location	string Example: location=München Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"forecastDate": "2022-06-29T07:06:08Z",
"nextUpdate": "2022-06-29T19:30:00Z",
"source": "w3Data",
"providerVersion": "prod-1.8.0",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"hourly": [{"date": "2022-06-28T22:00:00Z",
"weather": {"state": 2,
"text": "wolkig",
"icon": "n_2.svg"
},
"prec": {"sum": 0,
"probability": 0,
"sumAsRain": 0,
"class": 0
},
"temperature": {"avg": 18
},
"wind": {"unit": "km/h",
"direction": "Nordostwind",
"text": "NO",
"avg": 3,
"min": 3,
"max": 3,
"mean": 3,
"degree": 35,
"gusts": {"value": 10,
"text": ""
},
"significationWind": false
},
"text": "Der Himmel ist aktuell in München bewölkt bei 24 Grad. Der Wind kommt aus westlicher Richtung."
}
]
}

Get forecast spaces information

Get voice forecast for a given period {space} on a given day {date} for ({latitude},{longitude}) named {location}

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)
space required	string Enum: "morning" "afternoon" "evening" "night" Example: morning Period of day - Options are morning (6-12), afternoon (12-18), evening (18-22) or night (22-6)

query Parameters

date	string 8 characters ^[0-9]*$ Example: date=20220714 Optional parameter to specify the forecast date - if it is not given, the actual day is used
location	string Example: location=München Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"forecastDate": "2022-06-29T07:06:08Z",
"nextUpdate": "2022-06-29T19:30:00Z",
"source": "w3Data",
"providerVersion": "prod-1.8.0",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"spaces": [{"date": "2022-06-29",
"morning": {"date": "2022-06-29",
"from": "2022-06-29T20:00:01Z",
"to": "2022-06-30T04:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
},
"afternoon": {"date": "2022-06-29",
"from": "2022-06-29T20:00:01Z",
"to": "2022-06-30T04:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
},
"evening": {"date": "2022-06-29",
"from": "2022-06-29T20:00:01Z",
"to": "2022-06-30T04:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
},
"night": {"date": "2022-06-29",
"from": "2022-06-29T20:00:01Z",
"to": "2022-06-30T04:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
}
}
],
"text": "Der Himmel ist in München heute Abend leicht bewölkt bei 19 bis 22 Grad. Die Niederschlagswahrscheinlichkeit beträgt 85 Prozent mit bis zu 0,4 Millimeter Niederschlag. Die Sonne ist kaum zu sehen. Der Wind kommt aus nordwestlicher Richtung."
}

Get forecast summary information

Get voice forecast for a given day {datefrom} for ({latitude},{longitude}) named {location}. The API returns all hours between {datefrom} and {dateto}, if the parameters are set.

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

datefrom	string 8 characters ^[0-9]*$ Example: datefrom=20220714 Optional parameter to specify the forecast date - if it is not given, the actual datetime is used
datetimeto	string 8 characters ^[0-9]*$ Example: datetimeto=20220714 Optional parameter to specify the latest forecast date - if it is not given, the datetimefrom is used
location	string Example: location=München Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"forecastDate": "2022-06-29T07:06:08Z",
"nextUpdate": "2022-06-29T19:30:00Z",
"source": "w3Data",
"providerVersion": "prod-1.8.0",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"summary": [{"date": "2022-06-29",
"from": "2022-06-29T04:00:00Z",
"to": "2022-06-29T20:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
},
"text": "In München ist es heute bedeckt bei 17 und warmen 24 Grad. Es fällt mit 85 Prozent Wahrscheinlichkeit 0,4 Millimeter Niederschlag. Die Sonne schaut manchmal hinter den Wolken hervor. Der Wind kommt aus westlicher Richtung."
}
]
}

Get forecast weekend information

Get voice forecast for a given weekend {date} for ({latitude},{longitude}) named {location}. The API returns always the entire weekend forecast, if {date} is on a weekend or the next weekend, if {date} is within the week.

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

date	string 8 characters ^[0-9]*$ Example: date=20220714 Optional parameter to specify the forecast date - if it is not given, the next weekend is used
location	string Example: location=München Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"forecastDate": "2022-06-29T07:06:08Z",
"nextUpdate": "2022-06-29T19:30:00Z",
"source": "w3Data",
"providerVersion": "prod-1.8.0",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"summary": [{"date": "2022-06-29",
"from": "2022-06-29T04:00:00Z",
"to": "2022-06-29T20:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
}
],
"text": "In München ist es am Wochenende am Samstag leicht bewölkt und am Sonntag sonnig. Der Wind dreht von östlicher auf westliche Richtung. Am Samstag liegen die Temperaturen bei elf Grad, dabei scheint die Sonne bis zu neun Stunden. Am Sonntag liegen die Temperaturen bei 17 und sehr warmen 29 Grad, dabei scheint die Sonne bis zu 13 Stunden."
}

Get forecast next three days information

Get voice forecast for the next three days for ({latitude},{longitude}) named {location}

Authorizations:

ApiKeyAuth

path Parameters

latitude required	number <float> [ -90 .. 90 ] ^[+-]?[0-9]{1,3}.?[0-9]{0,5}$ Example: 48.13715 Latitude as decimal degrees (up to 5 decimals)
longitude required	number <float> [ -180 .. 180 ] Example: 11.57612 Longitude as decimal degrees (up to 5 decimals)

query Parameters

location

string

Example: location=München

Name of the location, if it is not filled, we use our geolocation to get the closest city

Responses

Response samples

200

Content type

application/json

{"forecastDate": "2022-06-29T07:06:08Z",
"nextUpdate": "2022-06-29T19:30:00Z",
"source": "w3Data",
"providerVersion": "prod-1.8.0",
"lat": 46.95828,
"lon": 12.34828,
"region": "München",
"summary": [{"date": "2022-06-29",
"from": "2022-06-29T04:00:00Z",
"to": "2022-06-29T20:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
}
],
"spaces": [{"date": "2022-06-29",
"night": {"date": "2022-06-29",
"from": "2022-06-29T20:00:01Z",
"to": "2022-06-30T04:00:00Z",
"sunHours": 2,
"weather": {"state": 3,
"text": "bedeckt",
"icon": "d_3.svg"
},
"prec": {"sum": 0.41,
"probability": 85,
"sumAsRain": 0,
"class": 1
},
"temperature": {"min": 17,
"max": 24,
"avg": 20
},
"wind": {"unit": "km/h",
"direction": "Westwind",
"text": "W",
"avg": 2,
"min": 2,
"max": 11,
"mean": 7,
"degree": 270,
"gusts": {"value": 28,
"text": ""
},
"significationWind": false
}
}
}
],
"text": "In München ist es bewölkt und es kann zu leichtem Niederschlag kommen, dabei wechseln sich Sonne und Wolken bei sieben Sonnenstunden ab. Die Höchsttemperaturen liegen bei 32 Grad mit starken Windböen. In der Nacht auf morgen bleibt es bewölkt und es kann zu leichtem Niederschlag kommen. Die Temperaturen sinken auf 17 Grad und der Wind flaut ab. Morgen ist es leicht bewölkt, dabei scheint die Sonne bis zu acht Stunden. Mit 25 Grad wird es etwas kühler. In der Nacht ist es bewölkt und trocken. Die Temperaturen sinken auf 14 Grad. Übermorgen ist es nochmal leicht bewölkt, dabei scheint die Sonne bis zu neun Stunden. Die Temperatur steigt auf 24 Grad und es gibt starke Windböen. In der Nacht ist es klar und trocken. Die Temperaturen sinken auf zwölf Grad und der Wind flaut ab."
}