{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-tropical-observations-feature-collection-schema.json",
  "title": "TropicalObservationsFeatureCollection",
  "description": "GeoJSON FeatureCollection of Hurricane Hunter VDM fixes and/or\nHDOB flight-level observations. Returned as `application/geo+json`\nfrom `GET /v1/tropical/observations`. Each feature is a Point\nwith `valid_time` in `properties`; additional recon keys\n(kind, atcf, aircraft, …) may appear without a sw-api release.\n\nForeign member `storms[]` is the newest VDM fix per storm or\nunnumbered USAF mission, queried independently of `kind` and\n`limit`. Experimental: dropsonde/RECCO will add `kind` values\nand properties.\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/TropicalObservationsFeatureCollection",
  "type": "object",
  "x-stability": "experimental",
  "required": [
    "type",
    "features"
  ],
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "FeatureCollection"
      ]
    },
    "features": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GeoJSONReportsFeature"
      }
    },
    "storms": {
      "type": "array",
      "description": "Newest VDM fix per storm (or unnumbered USAF mission).\nAlways present; empty array when none match the window.\n",
      "items": {
        "$ref": "#/$defs/TropicalObservationStorm"
      }
    }
  },
  "additionalProperties": true,
  "$defs": {
    "GeoJSONReportsFeature": {
      "type": "object",
      "description": "Shared per-feature shape used by `StormReportsFeatureCollection`\nand `RecordEventsFeatureCollection`. `geometry` is opaque GeoJSON\n(typically `Point`), and the only stable `properties` key is\n`valid_time`.\n",
      "required": [
        "type",
        "geometry",
        "properties"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "Feature"
          ]
        },
        "geometry": {
          "type": "object",
          "description": "GeoJSON geometry (typically `Point`). Treat as opaque\nGeoJSON; pass through to the renderer unchanged.\n",
          "additionalProperties": true
        },
        "properties": {
          "$ref": "#/$defs/GeoJSONReportsProperties"
        }
      },
      "additionalProperties": true
    },
    "GeoJSONReportsProperties": {
      "type": "object",
      "description": "Per-feature property bag emitted by the storm-reports +\nrecord-events pipelines. `valid_time` is the only stable key;\nadditional keys may appear without a sw-api release\n(forward-compat).\n",
      "required": [
        "valid_time"
      ],
      "properties": {
        "valid_time": {
          "type": "string",
          "format": "date-time",
          "description": "UTC timestamp the report / record was observed or recorded.\n"
        }
      },
      "additionalProperties": true
    },
    "TropicalObservationStorm": {
      "type": "object",
      "x-stability": "experimental",
      "description": "Newest VDM center fix for one storm or unnumbered USAF mission.\n`atcf` and `storm_name` are JSON null on unnumbered missions\n(`WXWXA`).\n",
      "required": [
        "latest_fix_time",
        "lat",
        "lon"
      ],
      "properties": {
        "atcf": {
          "type": [
            "string",
            "null"
          ]
        },
        "storm_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "latest_fix_time": {
          "type": "string",
          "format": "date-time"
        },
        "lat": {
          "type": "number",
          "format": "double"
        },
        "lon": {
          "type": "number",
          "format": "double"
        },
        "min_slp_mb": {
          "type": [
            "number",
            "null"
          ]
        },
        "max_fl_wind_kt": {
          "type": [
            "number",
            "null"
          ]
        },
        "eye": {
          "type": [
            "string",
            "null"
          ]
        },
        "aircraft": {
          "type": [
            "string",
            "null"
          ]
        },
        "mission_id": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}