NIEM Examples - Road-Weather Transactions (HQ/HR)
Road Weather NIEM Specifications
This section provides format specifications and examples for NIEM Road/Weather transactions (HQ/HR).
Road/weather inquiries/responses do not have to be in a fixed format except for the time and date field preceding the text information in an inquiry and following the "text" in a response.
All Nlets NIEM messages must be based on the Nlets NIEM Message Structure and include the standard Nlets XML Header as detailed in Message Structure. The NIEM header and hierarchy of the elements in this section have been omitted to avoid redundancy. The associated schemas and instances should be consulted to determine the correct XPaths of the elements.
Element Dictionary
Transaction types detailed below include: Road Weather Query (HQ) and Road Weather Response (HR).
Query Formats
Road Weather Query (HQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
n2:InquiryDescriptionText
This element contains free text . Include personal descriptors (name, sex) with other relevant data (case number,
booking number, state ID, miscellaneous number) followed by any additional free text.
Response Formats
Road Weather Response (HR)
n2:NLETSResponseData
n2:ResponseText
This element will contain the free text response. Nlets recommends the use of
tags to ensure that the response does not contain any characters illegal in XML.
Road Weather NIEM Examples
Example 1: Road/Weather query sent by a user.
<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:nc="http://niem.gov/niem/niem-core/2.0" xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>HQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS20</nh2:OriginatingORIID>
<nh2:DestinationORIID>IN</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>NLTEST0001</nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="HQ">
<n2:InquiryDescriptionText>WEATHER</n2:InquiryDescriptionText>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 2: Road/Weather response received by user.
<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:nc="http://niem.gov/niem/niem-core/2.0" xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>HR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>INFOX0000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS45</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[NLTEST0001]]></nh2:DocumentControlFieldText>
<nh2:MessageReceiveDate>12/01/2019</nh2:MessageReceiveDate>
<nh2:MessageReceiveTime>09:45</nh2:MessageReceiveTime>
<nh2:MessageSendDate>12/01/2019</nh2:MessageSendDate>
<nh2:MessageSendTime>09:45</nh2:MessageSendTime>
<nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
<nh2:SendMessageNumeric>00162</nh2:SendMessageNumeric>
</n2:NLETSMessageHeader>
<n2:NLETSResponseData n2:key="HR">
<n2:ResponseText>INDIANA ROAD REPORT
INDIANA STATE POLICE INDIANAPOLIS, IN
1145 EST SUNDAY DEC 01 2019
****************************************************************************
ROAD CONDITION INFORMATION IS UPDATED FROM REPORTS PROVIDED BY TROOPERS FROM
EACH INDIANA STATE POLICE POST EVERY 4 HOURS; MORE FREQUENTLY IF CONDITIONS
DETERIORATE OR BECOME SEVERE. FOR THE MOST CURRENT INFORMATION AVAILABLE,
IT IS ADVISEABLE TO CONSULT LOCAL TELEVISION OR RADIO STATIONS, OR WEATHER
INFORMATION SOURCES ON THE INTERNET. WE ASK CITIZENS NOT TO CALL ANY INDIANA
STATE POLICE POST FOR CONDITION UPDATES, IN ORDER TO KEEP THE TELEPHONE LINES
FREE FOR EMERGENCY CALLS. THIS INFORMATION IS ALSO AVAILABLE ON OUR TOLL-FREE
RECORDED ROAD CONDITIONS LINE AT 1-800-555-5555.
ADDITIONAL INFORMATION CONCERNING ROAD SURFACE CONDITIONS CAN BE FOUND AT:
****************************************************************************
**** ROAD AND WEATHER CONDITIONS FOR THE STATE OF INDIANA ****
NORTHERN REGION
DISTRICT/14 SP LAFAYETTE
I-65 REMINGTON TO BROOKSTON WET
I-65 BROOKSTON TO LAFAYETTE WET
I-65 LAFAYETTE TO FRANKFORT WET
I-65 FRANKFORT TO THORNTOWN WET
I-74 ILLINOIS TO VEEDERSBURG WET
I-74 VEEDERSBURG TO CRAWFORDSVILLE WET
OTHER US AND STATE ROADS WET
SECONDARY ROADS WET
--------
DISTRICT/13 SP LOWELL
I-65 GARY TO CROWN POINT DRY
I-65 CROWN POINT TO ROSELAWN-DEMOTTE DRY
I-65 ROSELAWN-DEMOTTE TO REMINGTON DRY
I-80 ILLINOIS TO LAKE STATION-PORTAGE DRY
I-94 PORTAGE TO MICHIGAN CITY DRY
I-94 MICHIGAN CITY TO MICHIGAN DRY
OTHER US AND STATE ROADS DRY
SECONDARY ROADS DRY
--------
DISTRICT/16 SP PERU
US-31 COUNTIES- FULTON MIAMI WET
US-31 COUNTIES- HOWARD TIPTON WET
US-24 COUNTIES- CASS MIAMI WABASH WET
OTHER US AND STATE ROADS WET
SECONDARY ROADS WET
--------------------
DISTRICT/21 SP TOLL ROAD
I-80/90 ILLINOIS LINE TO SOUTH BEND --I-80/90 SOUTH BEND TO HOWE-LAGRANGE --I-80/90 HOWE-LAGRANGE TO OHIO LINE ------------------------------
DISTRICT/22 SP FORT WAYNE
I-69 MICHIGAN TO AUBURN DRY
I-69 AUBURN TO FORT WAYNE DRY
I-69 FORT WAYNE TO HUNTINGTON DRY
I-69 HUNTINGTON TO WARREN DRY
I-469 FORT WAYNE AREA DRY
US-6 COUNTIES- NOBLE DEKALB DRY
US-24 COUNTIES- HUNTINGTON ALLEN DRY
US-27 COUNTIES- ALLEN ADAMS DRY
US-30 COUNTIES- ALLEN WHITLEY DRY
DRY
SR-3 COUNTIES- ALLEN LAGRANGE NOBLE
DISTRICT/24 SP BREMEN
US-31 COUNTIES- SAINT JOSEPH MARSHALL --US-30 COUNTIES- KOSCIUSKO MARSHALL --US-6 COUNTIES- ELKHART MARSHALL --US-20 COUNTIES- ELKHART SAINT JOSEPH --SR-15 COUNTIES- ELKHART KOSCIUSKO --OTHER US AND STATE ROADS --SECONDARY ROADS --------------
CENTRAL REGION
DISTRICT/32 SP TERRE HAUTE
I-70 ILLINOIS THRU TERRE HAUTE TO BRAZIL DRY
US-36 COUNTIES- VERMILLION PARKE DRY
US-40 COUNTIES- VIGO CLAY DRY
US-41 COUNTIES- SULLIVAN VIGO DRY
US-41 COUNTIES- PARKE DRY
SR-59 COUNTIES- CLAY PARKE DRY
SR-63 COUNTIES- VIGO VERMILLION DRY
SECONDARY ROADS DRY
--------
DISTRICT/25 SP REDKEY
I-69 MARION GAS CITY HARTFORD CITY WET
I-69 HARTFORD CITY TO MUNCIE WET
US-27 COUNTIES- JAY RANDOLPH WET
SR-1 COUNTIES- JAY RANDOLPH WET
SR-3 COUNTIES- BLACKFORD DELAWARE WET
SR-18 COUNTIES- GRANT BLACKFORD JAY WET
SR-26 COUNTIES- JAY RANDOLPH WET
SR-28 COUNTIES- DELAWARE RANDOLPH WET
SR-32 COUNTIES- DELAWARE RANDOLPH WET
WET
SR-67 COUNTIES- DELAWARE JAY
DISTRICT/52 SP INDIANAPOLIS
I-465 INDIANAPOLIS AREA DRY
I-65 INDIANAPOLIS AREA DRY
I-65 EDINBURGH TO INDIANAPOLIS DRY
I-65 INDIANAPOLIS TO THORNTOWN DRY
I-70 INDIANAPOLIS AREA DRY
I-70 INDIANAPOLIS TO MONROVIA DRY
I-74 INDIANAPOLIS AREA DRY
OTHER US AND STATE ROADS DRY
SECONDARY ROADS DRY
----
DISTRICT/53 SP PUTNAMVILLE
I-74 INDIANAPOLIS TO JAMESTOWN WET
I-70 BRAZIL TO MONROVIA WET
I-70 MONROVIA TO INDIANAPOLIS WET
US-40 PLAINFIELD TO PUTNAMVILLE WET
US-231 COUNTIES- PUTNAM WET
SR-37 MARTINSVILLE TO INDIANAPOLIS WET
SR-67 MARTINSVILLE TO INDIANAPOLIS WET
OTHER US AND STATE ROADS WET
SECONDARY ROADS WET
----
DISTRICT/51 SP PENDLETON
I-69 INDIANAPOLIS TO ANDERSON AREA --I-70 INDIANAPOLIS TO KNIGHTSTOWN --US-31 COUNTY- HAMILTON --OTHER US AND STATE ROADS --SECONDARY ROADS ----------------------
DISTRICT/41 SP CONNERSVILLE
I-70 KNIGHTSTOWN TO NEW CASTLE WET
I-70 NEW CASTLE TO OHIO WET
SR-1 COUNTIES- WAYNE FAYETTE FRANKLIN WET
SR-44 COUNTIES- RUSH FAYETTE UNION WET
OTHER US AND STATE ROADS WET
SECONDARY ROADS WET
--
--------------
SOUTHERN REGION
DISTRICT/42 SP VERSAILLES
I-74 ST PAUL EXIT TO OHIO STATE LINE DRY
I-275 LAWRENCEBURG AREA DRY
US-50 HOLTON VERSAILLES AURORA LAWRENCEBURG DRY
US-421 GREENSBURG OSGOOD VERSAILLES MADISON DRY
SR-3 GREENSBURG WESTPORT DEPUTY DRY
SR-62 DILLSBORO FRIENDSHIP MADISON HANOVER DRY
SR-129 BATESVILE VERSAILES CROSS PLAINS VEVAYDRY
SR-350 OSGOOD MILAN MOORES HILL AURORA DRY
OTHER US AND STATE ROADS DRY
DRY
SECONDARY ROADS
DISTRICT/43 SP SEYMOUR
I-65 EDINBURGH-COLUMBUS AREA WET
I-65 SEYMOUR-CROTHERSILLE AREA WET
US-31 COUNTIES BARTHOLOMEW JACKSON WET
US-50 COUNTIES JACKSON JENNINGS WET
SR-3 COUNTY JENNINGS WET
OTHER US AND STATE ROADS WET
SECONDARY ROADS WET
------------
DISTRICT/45 SP SELLERSBURG
I-64 CAREFREE TO LANESVILLE DRY
I-64 LANESVILLE TO KENTUCKY DRY
I-65 KENTUCKY TO HENRYVILLE DRY
I-65 HENRYVILLE TO AUSTIN DRY
I-265 NEW ALBANY CLARKSVILLE JEFFERSONVILLE DRY
OTHER US AND STATE ROADS DRY
SECONDARY ROADS DRY
------------
DISTRICT/35 SP EVANSVILLE
I-64 ILLINOIS TO EVANSVILLE --I-64 EVANSVILLE TO HOLLAND-DALE AREA --I-164 EVANSVILLE AREA --US-41 COUNTIES- VANDERBURGH GIBSON --US-41 COUNTY- KNOX --OTHER US AND STATE ROADS --SECONDARY ROADS --------------
DISTRICT/34 SP JASPER
I-64 HOLLAND TO CAREFREE WET
OTHER US AND STATE ROADS WET
SECONDARY ROADS WET
----------------------------
DISTRICT/33 SP BLOOMINGTON
SR-37 COUNTIES- MONROE LAWRENCE NO ADVERSE ROAD
SR-45 COUNTIES- BROWN MONROE GREENE NO ADVERSE ROAD
SR-46 COUNTIES- BROWN MONROE OWEN NO ADVERSE ROAD
US-231 COUNTIES- OWEN GREENE NO ADVERSE ROAD
US-50 COUNTIES- LAWRENCE NO ADVERSE ROAD
SR-67 COUNTIES- GREENE OWEN NO ADVERSE ROAD
OTHER US AND STATE ROADS NO ADVERSE ROAD
SECONDARY ROADS NO ADVERSE ROAD
--------
***** END OF RESPONSE *****</n2:ResponseText>
</n2:NLETSResponseData>
</n2:NLETS>
Example 3: Road/Weather message received from National Weather Wire.
<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:nc="http://niem.gov/niem/niem-core/2.0" xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>HR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>WS0000000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS47</nh2:DestinationORIID>
<nh2:MessageReceiveDate>10/22/2019</nh2:MessageReceiveDate>
<nh2:MessageReceiveTime>09:34</nh2:MessageReceiveTime>
<nh2:MessageSendDate>10/22/2019</nh2:MessageSendDate>
<nh2:MessageSendTime>09:34</nh2:MessageSendTime>
<nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
<nh2:SendMessageNumeric>00779</nh2:SendMessageNumeric>
</n2:NLETSMessageHeader>
<n2:NLETSResponseData n2:key="HR">
<n2:ResponseText>FXUS64 KMEG 151528 AFDMEG Area Forecast Discussion National Weather Service Memphis TN 1028 AM CDT Mon Apr 15 2019
.UPDATE... Beautiful weather is on tap for the Mid-South today. Temperatures have warmed into the 50s area wide and will approach 70F by mid- afternoon.
Clouds have moved east with the departing trough, so we'll maintain clear skies today.
Winds are currently light from the south but will increase this afternoon in response to a tightening pressure gradient as a trough and attendant upper- level jet eject into the Northern Plains.
Winds will increase to 10-15 mph this afternoon along and west of the Mississippi River with gusts to 20 mph at times.
Southerly winds will relax a bit overnight but warm advection and boundary layer mixing will keep temperatures quite a bit warmer than this morning.
No big changes were included in the forecast update. Johnson &&
.PREV DISCUSSION... /issued 416 AM CDT Mon Apr 15 2019/
DISCUSSION... Currently...Weak surface highs pressure sits over the region with clear skies and light winds.
Good radiational cooling conditions helping temps fall into the 30s across parts of the Mid-South.
Expect frost across parts of the Mid-South especially locations in the Frost advisory which covers much of West Tennessee.
Patchy fog is also occurring near the TN River and across North Mississippi.
Today through Wednesday...High pressure will prevail today with sunny skies and slightly below normal temperatures.
Return flow will commence along and west of the River this afternoon. As a result expect warmer temps tonight with lows in the upper 40s and lower 50s.
As the high moves east southerly flow will increase on Tuesday pushing highs well into the 70s. Expect a breezy day across the Delta.
Breezy conditions continue into Wednesday as moisture continues to increase. Weak isentropic lift may result in a few showers during the AM west of the MS River.
A weak upper level disturbance combined with some instability could produce a few thunderstorms west of the river Wednesday afternoon. Highs will again be in the 70s.
Wednesday night through Thursday night...A potent upper level system will move out of the SW U.S. Wednesday night.
Moisture and instability will increase across the lower MS Valley with increasing shear as the upper trough pushes across the southern plains.
Convection with severe weather potential will develop over the ARKLATEX and spread NE overnight...gradually weakening as it moves into a less favorable environment.
A few strong to severe storms are possible late Wednesday night mainly west of the MS River. That first round will continue to spread east Thursday morning and weaken.
Another round of convection will likely develop across the area as a potent mid level shortwave rounds the base of the main upper trough and punches into the area during the day on Thursday.
Of course details of severe weather chances will depend on many things, like ongoing convection, how quickly the surface system occludes and the strength/timing of the shortwave etc.
Given the strong shear combined with a moist and somewhat unstable boundary layer strong to severe storms will be possible across the Mid-South Thursday.
Models are in good agreement with moving most of the activity east of the Mid-South by Thursday evening. Right now it looks like another 1.5 to 2.5 inches of rain possible with this event.
Friday and Friday night...A deep upper low will drop into the region by Friday with more showers and highs only in the 50s. Showers will begin tapering off Friday night with lows in the 40s.
Weekend...Looks sunny albeit a bit chilly on Saturday with strong NW flow on the backside of the departing upper low. Temps will climb into the 70s on Sunday.
SJM && .AVIATION... /12Z TAFs/ VFR. Light winds becoming south at 6-11kts.
Higher gusts at JBR. JAB &&
.MEG WATCHES/WARNINGS/ADVISORIES... AR...None. MO...None. MS...None. TN...None.
&& $$
</n2:ResponseText>
</n2:NLETSResponseData>
</n2:NLETS>