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 |
|
|
Station location |
|
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 |
|
Sustained wind and gusts remain separate so clients can distinguish ongoing conditions from brief peaks. |
|
|
|
Visibility and reported restriction |
|
Keeping the distance and its cause, rain, gives clients both the visibility measurement and its explanation. |
Ceiling and cloud coverage |
|
Ceiling records the broken cloud layer’s height above ground, while coverage describes how much sky the clouds obscure. |
Temperature and dew point |
|
Air temperature and dew point describe warmth and moisture. Dew point is the temperature at which moisture condenses. |
Precipitation categories |
|
The reported categories correspond to |
Rate and interval accumulation |
|
|
Source time, capture time, and complete source record |
|
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"
}
]
}