{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-tropical-feature-collection-schema.json",
  "title": "TropicalFeatureCollection",
  "description": "GeoJSON FeatureCollection aggregating the latest NHC tropical\noverlay (cone / track / points / watch-warning per active storm\nplus 7-day TWO areas). Returned as `application/geo+json` from\n`GET /v1/tropical`. Each feature carries a `kind` property the\nclient uses to choose its renderer; the property bag is\nforward-compat. Latest TCD/TCP/TWO bulletins are on `discussions[]`.\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/TropicalFeatureCollection",
  "type": "object",
  "required": [
    "type",
    "features"
  ],
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "FeatureCollection"
      ]
    },
    "features": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GeoJSONOpaqueFeature"
      }
    },
    "discussions": {
      "type": "array",
      "description": "Latest Tropical Cyclone Discussion (TCD) and Public Advisory\n(TCP) per storm, joined by ATCF id, plus the latest Tropical\nWeather Outlook (TWO) per basin (`storm_id` is `AT`/`EP`/`CP`).\nOmitted when none are available. Not stamped on\nindividual features.\n",
      "items": {
        "$ref": "#/$defs/TropicalDiscussion"
      }
    }
  },
  "additionalProperties": true,
  "$defs": {
    "GeoJSONOpaqueFeature": {
      "type": "object",
      "description": "Generic GeoJSON Feature with opaque geometry and a forward-compat\nproperty bag. Used by overlays (NEXRAD detections, tropical) whose\nper-feature property schema is owned by the data pipeline and\nmay evolve without a sw-api release. Treat `geometry` and all\n`properties` keys as opaque additive data.\n",
      "required": [
        "type",
        "geometry",
        "properties"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "Feature"
          ]
        },
        "geometry": {
          "type": "object",
          "description": "GeoJSON geometry (Point / LineString / Polygon / Multi*).\nTreat as opaque GeoJSON; pass through to the renderer\nunchanged.\n",
          "additionalProperties": true
        },
        "properties": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "TropicalDiscussion": {
      "type": "object",
      "x-stability": "experimental",
      "description": "Latest NHC tropical text product for one storm or basin. `storm_id`\nidentifies the product's storm or basin (`AT1` for TCD/TCP, `AT` for\nTWO). `atcf` is the ATCF storm id (`AL01`) that matches the storm on\nthe other tropical products.\n",
      "required": [
        "storm_id",
        "atcf",
        "product_type",
        "issued_at"
      ],
      "properties": {
        "storm_id": {
          "type": "string"
        },
        "atcf": {
          "type": "string"
        },
        "product_type": {
          "type": "string",
          "enum": [
            "TCD",
            "TCP",
            "TWO"
          ]
        },
        "source_ref": {
          "type": "string"
        },
        "issued_at": {
          "type": "string",
          "format": "date-time"
        },
        "summary": {
          "type": "string"
        },
        "body": {
          "type": "string"
        }
      }
    }
  }
}