La documentation pour développeurs est en anglais.
Type de carte
weather.forecast
Current conditions, the next hours and the next days. data.focus says which part was asked about.
Version 1 · schema weather.forecast.v1.schema.json
Layouts
Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.
Fields
The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.
| Field | Type | Required | Notes |
|---|---|---|---|
location | object | yes | |
location.name | string | yes | |
location.region | string | null | ||
location.country | string | yes | |
location.lat | number | yes | |
location.lon | number | yes | |
location.timezone | string | yes | |
units | object | yes | |
units.temperature | enum | yes | celsius · fahrenheit |
units.wind | enum | yes | km/h · mph · m/s |
units.precipitation | enum | yes | mm · in |
focus | enum | yes | Which part of the forecast the question asked about. now · today · tomorrow · week |
current | object | yes | |
current.time | date-time | yes | ISO 8601 date-time with offset. |
current.temperature | number | yes | |
current.feels_like | number | null | yes | Apparent temperature from temperature, humidity and wind. |
current.condition | enum | yes | clear · partly_cloudy · cloudy · fog · light_rain · rain · heavy_rain · sleet · snow · thunderstorm |
current.wind_speed | number | null | yes | |
current.wind_direction_deg | number | null | ||
current.humidity | number | null | yes | |
current.precipitation_probability | number | null | yes | |
current.precipitation | number | null | yes | Expected in the next hour, in units.precipitation. |
hourly[] | object[] | yes | |
hourly[].time | date-time | yes | ISO 8601 date-time with offset. |
hourly[].temperature | number | yes | |
hourly[].condition | enum | yes | clear · partly_cloudy · cloudy · fog · light_rain · rain · heavy_rain · sleet · snow · thunderstorm |
hourly[].precipitation_probability | number | null | yes | |
hourly[].precipitation | number | null | yes | Amount in units.precipitation (mm or in). |
daily[] | object[] | yes | |
daily[].date | date | yes | ISO 8601 calendar date. |
daily[].high | number | yes | |
daily[].low | number | yes | |
daily[].condition | enum | yes | clear · partly_cloudy · cloudy · fog · light_rain · rain · heavy_rain · sleet · snow · thunderstorm |
daily[].precipitation_probability | number | null | yes | |
daily[].precipitation | number | null | yes | Amount in units.precipitation (mm or in). |
Example
A recorded answer to “What is the weather in Dresden?”. Open it in the Answer Lab to see every layout and style.
{
"v": 2,
"id": "ans_c29351492af2",
"matched": true,
"locale": "en",
"skill": "weather",
"confidence": 0.98,
"text": "15° and partly cloudy in Dresden right now. Light rain starts around 8 pm and gets heavier after 10 pm; it eases off by about 7 am, and Thursday stays mostly dry with a high of 12°.",
"speech": "It's 15 degrees and partly cloudy in Dresden. Rain starts this evening and lasts until early morning.",
"card": {
"type": "weather.forecast",
"version": 1,
"data": {
"location": {
"name": "Dresden",
"region": "Saxony",
"country": "DE",
"lat": 51.05,
"lon": 13.74,
"timezone": "Europe/Berlin"
},
"units": {
"temperature": "celsius",
"wind": "km/h",
"precipitation": "mm"
},
"current": {
"time": "2026-10-21T14:00:00+02:00",
"temperature": 15,
"feels_like": 12,
"condition": "partly_cloudy",
"wind_speed": 11,
"wind_direction_deg": 120,
"humidity": 71,
"precipitation_probability": null,
"precipitation": 0
},
"hourly": [
{
"time": "2026-10-21T16:00:00+02:00",
"temperature": 15,
"condition": "partly_cloudy",
"precipitation": 0,
"precipitation_probability": null
},
{
"time": "2026-10-21T18:00:00+02:00",
"temperature": 13,
"condition": "partly_cloudy",
"precipitation": 0,
"precipitation_probability": null
},
{
"time": "2026-10-21T20:00:00+02:00",
"temperature": 11,
"condition": "light_rain",
"precipitation": 0.1,
"precipitation_probability": null
},
{
"time": "2026-10-21T22:00:00+02:00",
"temperature": 10,
"condition": "heavy_rain",
"precipitation": 1,
"precipitation_probability": null
},
{
"time": "2026-10-22T00:00:00+02:00",
"temperature": 10,
"condition": "heavy_rain",
"precipitation": 1.6,
"precipitation_probability": null
},
{
"time": "2026-10-22T02:00:00+02:00",
"temperature": 9,
"condition": "heavy_rain",
"precipitation": 2.6,
"precipitation_probability": null
},
{
"time": "2026-10-22T04:00:00+02:00",
"temperature": 9,
"condition": "rain",
"precipitation": 0.7,
"precipitation_probability": null
},
{
"time": "2026-10-22T06:00:00+02:00",
"temperature": 9,
"condition": "rain",
"precipitation": 0.3,
"precipitation_probability": null
}
],
"daily": [
{
"date": "2026-10-21",
"high": 15,
"low": 10,
"condition": "rain",
"precipitation_probability": null,
"precipitation": 2.9
},
{
"date": "2026-10-22",
"high": 12,
"low": 8,
"condition": "partly_cloudy",
"precipitation_probability": null,
"precipitation": 9.6
},
{
"date": "2026-10-23",
"high": 13,
"low": 5,
"condition": "cloudy",
"precipitation_probability": null,
"precipitation": 1.8
},
{
"date": "2026-10-24",
"high": 11,
"low": 8,
"condition": "cloudy",
"precipitation_probability": null,
"precipitation": 0.6
}
],
"focus": "now"
}
},
"sources": [
{
"name": "MET Norway",
"url": "https://api.met.no",
"license": "CC BY 4.0"
}
],
"follow_ups": [
"Do I need an umbrella tomorrow?",
"When is sunset today?"
],
"actions": [],
"usage": {
"billable": true
}
}