Map a Weather Observation

A station weather Object gives [R]DP clients the latest airfield conditions through typeInfo.weather, useful for flight and route planning. details adds custom measurements, while externalRefs preserves the source JSON.

Source data

The input is a station observation in JSON, with coordinates in WGS-84, the geographic reference used by GPS. stationAuthority and stationId identify the weather feed; observedAt gives the observation time and receivedAt gives capture time. Original message bytes are unavailable.

METAR is a standard format for aviation weather observations, including wind, visibility, and temperature. This example also includes station measurements of rain rate and accumulation, which METAR reports may lack.

{
  "stationAuthority": "demo-network",
  "stationId": "station-7",
  "stationName": "Demo Airfield",
  "latitudeDegrees": 38.0,
  "longitudeDegrees": -77.0,
  "observedAt": "2026-10-01T12:00:00Z",
  "receivedAt": "2026-10-01T12:00:02Z",
  "reportId": "weather-report-001",
  "windSpeedKnots": 12.0,
  "windGustKnots": 20.0,
  "windFromDegreesTrue": 270.0,
  "visibilityMeters": 4000.0,
  "visibilityRestriction": "rain",
  "cloudCoverage": "broken",
  "ceilingFeetAgl": 1000.0,
  "temperatureCelsius": 18.0,
  "dewPointCelsius": 16.0,
  "precipitation": {
    "type": "rain",
    "intensity": "moderate",
    "rateMmPerHour": 5.0,
    "accumulationMm": 6.0,
    "accumulationStart": "2026-10-01T11:00:00Z",
    "accumulationEnd": "2026-10-01T12:00:00Z"
  }
}

Field mapping

WDM’s weather fields use common units for comparing feeds: meters per second for wind, meters for visibility and ceiling, and Celsius for temperature. The station identity connects new observations to one location; details adds precipitation measurements with their units and time interval.

Source WDM field Explanation

Station authority and ID

id, identities

weather:demo-network:station-7 identifies the conditions at this station, so each observation refreshes the same Object. The observation’s own ID remains in provenance and the source reference.

Station location

location.position

The coordinates let clients place the observation on a map. They locate the measurement, rather than an area where conditions are assumed uniform.

Wind speed and gusts

typeInfo.weather.windSpeedMps, windGustMps

Sustained wind and gusts remain separate so clients can distinguish ongoing conditions from brief peaks.

windFromDegreesTrue: 270

typeInfo.weather.windDirectionDegrees

270 degrees true means wind from the west. Wind direction belongs to the weather fields; motion describes movement of the Object itself.

Visibility and reported restriction

typeInfo.weather.visibilityMeters, visibilityRestriction

Keeping the distance and its cause, rain, gives clients both the visibility measurement and its explanation.

Ceiling and cloud coverage

typeInfo.weather.ceilingMetersAgl, cloudCoverage

Ceiling records the broken cloud layer’s height above ground, while coverage describes how much sky the clouds obscure.

Temperature and dew point

typeInfo.weather.temperatureCelsius, dewPointCelsius

Air temperature and dew point describe warmth and moisture. Dew point is the temperature at which moisture condenses.

Precipitation categories

typeInfo.weather.precipitationType, precipitationIntensity

The reported categories correspond to PRECIPITATION_TYPE_RAIN and PRECIPITATION_INTENSITY_MODERATE; the numeric rate alone does not establish intensity.

Rate and interval accumulation

details

com.example.mapping.v1.ReportedPrecipitation groups these measurements with their units and time interval in details.

Source time, capture time, and complete source record

provenance, ttl, externalRefs

Source and capture times remain separate. Conditions expire 15 minutes after observation so older measurements do not remain current. A Struct, a protobuf container for JSON-like fields, retains the source JSON.

This example represents measured conditions rather than a tactical entity, so it leaves military symbology unset.

Precipitation

Precipitation rate measures how quickly rain is falling at the observation time; accumulation is the total over an interval. Here the rate is 5 mm/hour and accumulation is 6 mm between 11:00 and 12:00 UTC. These describe different measurements, so the current rate need not equal the preceding hour’s average.

PRECIPITATION_TYPE_NONE means a confirmed dry observation; an unknown type stays absent or unspecified. Zero remains a valid measurement. This example uses the source’s "moderate" category because numeric light/moderate/heavy thresholds depend on the source’s definitions.

The accumulation interval stays with the number in details: six millimeters over an hour differs from six millimeters over a day. details.@type labels the custom structure; producers and clients agree on its field meanings and units.

These fields add richness beyond WDM’s precipitation categories. A stream or data-feed filter can use details.value.rateMmPerHour to select observations by rain rate without unpacking the source record. See Modeling with WDM for this convention. The complete input remains in externalRefs, as described in Preserve Source Data.

WDM Object

The record uses ProtoJSON, protobuf’s JSON representation. See Publish Object for how to send it.

{
  "id": "weather:demo-network:station-7",
  "security": {
    "raw": "UNCLASSIFIED",
    "components": {
      "classification": "UNCLASSIFIED",
      "ownerProducer": [
        "USA"
      ]
    }
  },
  "name": "Demo Airfield weather",
  "identities": [
    {
      "system": "weather:demo-network",
      "identifier": "station-7"
    }
  ],
  "ontology": {
    "category": "ONTOLOGY_CATEGORY_OBSERVATION",
    "type": "Station weather observation"
  },
  "flags": {
    "isSimulated": true
  },
  "status": "OBJECT_STATUS_ACTIVE",
  "ttl": "2026-10-01T12:15:00Z",
  "location": {
    "position": {
      "latitudeDegrees": 38.0,
      "longitudeDegrees": -77.0
    }
  },
  "typeInfo": {
    "weather": {
      "windSpeedMps": 6.173333333333333,
      "windDirectionDegrees": 270.0,
      "windGustMps": 10.28888888888889,
      "visibilityMeters": 4000.0,
      "visibilityRestriction": "VISIBILITY_RESTRICTION_RAIN",
      "ceilingMetersAgl": 304.8,
      "cloudCoverage": "CLOUD_COVERAGE_BKN",
      "precipitationType": "PRECIPITATION_TYPE_RAIN",
      "precipitationIntensity": "PRECIPITATION_INTENSITY_MODERATE",
      "temperatureCelsius": 18.0,
      "dewPointCelsius": 16.0
    }
  },
  "details": {
    "@type": "com.example.mapping.v1.ReportedPrecipitation",
    "value": {
      "rateMmPerHour": 5.0,
      "accumulation": {
        "depthMm": 6.0,
        "start": "2026-10-01T11:00:00Z",
        "end": "2026-10-01T12:00:00Z"
      }
    }
  },
  "provenance": {
    "id": "weather-report-001",
    "name": "Demo Airfield weather station 7",
    "updatedAt": "2026-10-01T12:00:00Z",
    "producer": "example-weather-adapter-v1"
  },
  "externalRefs": [
    {
      "typeUrl": "type.googleapis.com/google.protobuf.Struct",
      "externalId": "weather-report-001",
      "sourceSystem": "demo-airfield-weather",
      "payload": {
        "@type": "type.googleapis.com/google.protobuf.Struct",
        "value": {
          "@type": "com.example.mapping.v1.DecodedSourceRecord",
          "value": {
            "format": "weather-station-observation",
            "profile": "Airfield station; normalized fixture contract",
            "mediaType": "application/json",
            "representation": "decoded_record",
            "originalWireDataAvailable": false,
            "record": {
              "stationAuthority": "demo-network",
              "stationId": "station-7",
              "stationName": "Demo Airfield",
              "latitudeDegrees": 38.0,
              "longitudeDegrees": -77.0,
              "observedAt": "2026-10-01T12:00:00Z",
              "receivedAt": "2026-10-01T12:00:02Z",
              "reportId": "weather-report-001",
              "windSpeedKnots": 12.0,
              "windGustKnots": 20.0,
              "windFromDegreesTrue": 270.0,
              "visibilityMeters": 4000.0,
              "visibilityRestriction": "rain",
              "cloudCoverage": "broken",
              "ceilingFeetAgl": 1000.0,
              "temperatureCelsius": 18.0,
              "dewPointCelsius": 16.0,
              "precipitation": {
                "type": "rain",
                "intensity": "moderate",
                "rateMmPerHour": 5.0,
                "accumulationMm": 6.0,
                "accumulationStart": "2026-10-01T11:00:00Z",
                "accumulationEnd": "2026-10-01T12:00:00Z"
              }
            }
          }
        }
      },
      "capturedAt": "2026-10-01T12:00:02Z",
      "label": "Decoded airfield weather observation"
    }
  ]
}