{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-storm-tracks-feature-collection-schema.json",
  "title": "StormTracksFeatureCollection",
  "description": "GeoJSON FeatureCollection of active storm-cell tracks. Returned\nas `application/geo+json` from `GET /v1/storm-tracks`.\n\nThe schema below documents the stable subset of the wire\nformat. The data pipeline may add new keys to\n`properties` (e.g. richer `impact.*` sub-objects, additional\ncell-classification fields) without a sw-api release; clients\nshould treat unknown keys as opaque additive data and never\nfail-closed on their presence.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/smarterweather-com-storms-api-openapi.yml#/components/schemas/StormTracksFeatureCollection",
  "type": "object",
  "required": [
    "type",
    "features"
  ],
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "FeatureCollection"
      ]
    },
    "features": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/StormTrackFeature"
      }
    }
  },
  "additionalProperties": true,
  "$defs": {
    "StormTrackFeature": {
      "type": "object",
      "description": "Single storm-cell GeoJSON Feature. `geometry` is the projected\ntrack polyline; `properties` carries per-cell metadata.\n",
      "required": [
        "type",
        "geometry",
        "properties"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "Feature"
          ]
        },
        "geometry": {
          "type": "object",
          "description": "GeoJSON geometry (typically `LineString` or `MultiLineString`).\nTreat as opaque GeoJSON; pass through to the renderer\nunchanged.\n",
          "additionalProperties": true
        },
        "properties": {
          "$ref": "#/$defs/StormTrackProperties"
        }
      },
      "additionalProperties": true
    },
    "StormTrackProperties": {
      "type": "object",
      "description": "Per-cell property bag emitted by the storm-tracks pipeline.\nStable keys are listed below; additional keys may appear\nwithout a sw-api release (forward-compat).\n",
      "required": [
        "cell_id",
        "site_id"
      ],
      "properties": {
        "cell_id": {
          "type": "string",
          "description": "Pipeline-assigned cell identifier (stable across scans)."
        },
        "site_id": {
          "type": "string",
          "description": "3-letter NEXRAD radar site code that produced the cell."
        },
        "scan_time": {
          "type": "string",
          "format": "date-time",
          "description": "Radar scan timestamp the cell was observed at."
        },
        "valid_time": {
          "type": "string",
          "format": "date-time",
          "description": "Forecast valid-time (extrapolated). May equal `scan_time`\nfor cells without an extrapolation.\n"
        },
        "impact": {
          "type": "object",
          "description": "Optional impact metadata. Populated only when the request\nincluded `detailed=true`. Property bag is forward-compat:\nnew fields may appear without a sw-api release.\n",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    }
  }
}