TimelineInterval

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tomorrow/refs/heads/main/json-schema/timeline-interval-schema.json",
  "title": "TimelineInterval",
  "description": "A single timestep entry in a timeline.",
  "type": "object",
  "properties": {
    "startTime": {
      "type": "string",
      "format": "date-time",
      "example": "2026-05-30T13:00:00Z"
    },
    "values": {
      "type": "object",
      "description": "Map of weather data field names to numeric values for one timestep.",
      "additionalProperties": true,
      "properties": {
        "temperature": {
          "type": "number",
          "format": "double",
          "description": "Air temperature (Celsius for metric, Fahrenheit for imperial).",
          "example": 21.2
        },
        "temperatureApparent": {
          "type": "number",
          "format": "double",
          "example": 20.4
        },
        "humidity": {
          "type": "number",
          "format": "double",
          "example": 64.0
        },
        "dewPoint": {
          "type": "number",
          "format": "double",
          "example": 13.4
        },
        "windSpeed": {
          "type": "number",
          "format": "double",
          "example": 3.1
        },
        "windDirection": {
          "type": "number",
          "format": "double",
          "example": 220
        },
        "windGust": {
          "type": "number",
          "format": "double",
          "example": 6.2
        },
        "pressureSeaLevel": {
          "type": "number",
          "format": "double",
          "example": 1013.2
        },
        "pressureSurfaceLevel": {
          "type": "number",
          "format": "double",
          "example": 1010.5
        },
        "precipitationIntensity": {
          "type": "number",
          "format": "double",
          "example": 0.0
        },
        "precipitationProbability": {
          "type": "number",
          "format": "double",
          "example": 5
        },
        "precipitationType": {
          "type": "integer",
          "example": 0
        },
        "cloudCover": {
          "type": "number",
          "format": "double",
          "example": 12
        },
        "cloudBase": {
          "type": "number",
          "format": "double",
          "example": 1.5
        },
        "cloudCeiling": {
          "type": "number",
          "format": "double",
          "example": 2.4
        },
        "visibility": {
          "type": "number",
          "format": "double",
          "example": 16
        },
        "weatherCode": {
          "type": "integer",
          "example": 1000
        },
        "uvIndex": {
          "type": "integer",
          "example": 6
        },
        "uvHealthConcern": {
          "type": "integer",
          "example": 2
        },
        "epaIndex": {
          "type": "integer",
          "example": 42
        },
        "epaHealthConcern": {
          "type": "integer",
          "example": 1
        },
        "epaPrimaryPollutant": {
          "type": "integer",
          "example": 0
        },
        "particulateMatter25": {
          "type": "number",
          "format": "double",
          "example": 8.4
        },
        "particulateMatter10": {
          "type": "number",
          "format": "double",
          "example": 14.1
        },
        "pollutantO3": {
          "type": "number",
          "format": "double",
          "example": 28
        },
        "pollutantNO2": {
          "type": "number",
          "format": "double",
          "example": 11
        },
        "pollutantCO": {
          "type": "number",
          "format": "double",
          "example": 0.4
        },
        "pollutantSO2": {
          "type": "number",
          "format": "double",
          "example": 1
        },
        "treeIndex": {
          "type": "integer",
          "example": 2
        },
        "grassIndex": {
          "type": "integer",
          "example": 1
        },
        "weedIndex": {
          "type": "integer",
          "example": 1
        },
        "fireIndex": {
          "type": "number",
          "format": "double",
          "example": 8.2
        },
        "solarGHI": {
          "type": "number",
          "format": "double",
          "example": 480
        },
        "solarDIF": {
          "type": "number",
          "format": "double",
          "example": 120
        },
        "solarDIR": {
          "type": "number",
          "format": "double",
          "example": 360
        },
        "moonPhase": {
          "type": "integer",
          "example": 3
        },
        "hailBinary": {
          "type": "integer",
          "example": 0
        }
      }
    }
  }
}