NIEM Examples - Railroad Crossing Transactions (RCQ/RCR)

Railroad Crossing NIEM Specifications

This section provides NIEM format and examples for Railroad Crossing Transactions (RCQ/RCR).

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: Railroad Crossing Query (RCQ) and Railroad Crossing Response (RCR).

Query Formats

Railroad Crossing query (RCQ)

n:NLETSInquiryData
This element will contain all elements specific to this transaction.

j:RoadwayRailwayCrossingIdentification
A unique US DOT/AAR number assigned for identification purposes to a railroad crossing by a state highway agency in cooperation with the Federal Railroad Administration.

nc:IdentificationID
A value that identifies something.

Response Formats

Railroad Crossing response (RCR)

n2-rcr:RoadwayRailwayCrossing
The business data returned in response to a Railroad Crossing Inquiry. The inquiry can be made on a Railroad Crossing ID.

j:RoadwayRailwayCrossingIdentification
A unique US DOT/AAR number assigned for identification purposes to a railroad crossing by a state highway agency in cooperation with the Federal Railroad Administration

n2-rcr:RoadwayRailwayCrossingLocation
The location of the railroad crossing

nc:LocationDescriptionText
A description of a location.

nc:Address
A postal location to which paper mail can be directed

nc:LocationStreet
A road, thoroughfare or highway

nc:StreetName
A name of a street.

nc:LocationCityName
A name of a city or town

nc:LocationCountyName
A name of a county, parish, vicinage, or other such geopolitical subdivision of a state.

nc:LocationStateFIPS5-2AlphaCode
A state, commonwealth, province, or other such geopolitical subdivision of a country.

nc:AddressHighway
A major public road

nc:HighwayID
An identifier of a highway.

n2-rcr:HighwayAugmentation
An augmentation point for HighwayType

n2-rcr:HighwayTypeText
The type of highway

nc:Location2DGeospatialCoordinate
A location identified by a latitude and longitude

nc:GeographicCoordinateLatitutde
A measurement of the angular distance between a point on the Earth and the Equator.

nc:GeographicCoordinateLongitude
A measurement of the angular distance between a point on the Earth and the Prime Meridian.

n2-rcr:Location2DGeospatialCoordinateAugmentation
An augmentation point for Location2DGeospatialCoordinateType

n2-rcr:CoordinateSourceText
This element indicates if the coordinates are actual or derived

n2-rcr:LocationAugmentation
An augmentation point for LocationType.

n2-rcr:LocationRailroadMilepostText
The milepost value

n2-rcr:RailroadOperatingCompany
The company operating the railroad at the crossing

nc:OrganizationEmergencyContactInformation
A means of contacting an organization in the event of an emergency.

nc:ContactTelephoneNumber
A telephone number for a telecommunication device by which a person or organization may be contacted.

nc:FullTelephoneNumber
A full telephone number.

nc:OrganizationIdentification
An identification that references an organization.

nc:OrganizationName
A name of an organization.

n2-rcr:NearestRailroadTimetableStationText
The timetable station located nearest to the crossing

n2-rcr:BranchNameText
Branch/Line name

n2-rcr:CrossingTypeText
The type of crossing (Pedestrian at grade, Pedestrian RR under, Pedestrian RR over, Private at grade,
Private RR under, Private RR over, Public at grade, Public RR under, Public RR over)

n2-rcr:CrossingPositionText
The position of crossing (At grade under, RR Under, RR over)

n2-rcr:CrossingCategoryText
The category of the crossing (Farm, Residential, Recreational, Industrial, Commercial)

n2-rcr:CrossingLowFrequencyIndicator
true if a crossing train frequency is fewer than one train per day

n2-rcr:CrossingWarningDeviceDescriptionText
A description of warning devices present at crossing (No signs or signals, Other signs or Signals,
Crossbucks, Stop signs, Special Active Warning Devices, Highway traffic signals, wigwags, bells,
or other activated, Flashing lights, All other Gates, Four Quad (full barrier) Gates)

n2-rcr:CrossingTrainSignalIndicator
true if the track is equipped with train signals

n2-rcr:CrossingTrainDetectionIndicator
true if the track is equipped with train detection

n2-rcr:CrossingNearbyHighwayIndicator
true if there is a nearby intersection highway within 75 feet

n2-rcr:CrossingStateHighwayOrganization
The State Highway contact associated with the crossing

nc:OrganizationEmergencyContactInformation
A means of contacting an organization in the event of an emergency.

nc:ContactTelephoneNumber
A telephone number for a telecommunication device by which a person or organization may be contacted.

nc:FullTelephoneNumber
A full telephone number.

n2-rcr:CrossingOwnerOrganization
The crossing owner associated with the crossing

nc:OrganizationEmergencyContactInformation
A means of contacting an organization in the event of an emergency.

nc:ContactTelephoneNumber
A telephone number for a telecommunication device by which a person or organization may be contacted.

nc:FullTelephoneNumber
A full telephone number.

nc:OrganizationName
A name of an organization.

Railroad Crossing NIEM Examples

Example 1: Query of a Railroad Crossing transaction.

<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>RCQ</nh2:MessageKeyCodeText>
    <nh2:OriginatingORIID>AZNLETS20</nh2:OriginatingORIID>
    <nh2:DestinationORIID>NL</nh2:DestinationORIID>
  </n2:NLETSMessageHeader>
  <n2:NLETSInquiryData n2:key="RCQ">
    <j:RoadwayRailwayCrossingIdentification xmlns:j="http://release.niem.gov/niem/domains/jxdm/5.0/">
      <nc:IdentificationID>012239W</nc:IdentificationID>
    </j:RoadwayRailwayCrossingIdentification>
  </n2:NLETSInquiryData>
</n2:NLETS>

Example 2: Response to a Railroad Crossing query.

<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>RCR</nh2:MessageKeyCodeText>
    <nh2:OriginatingORIID>NL0000000</nh2:OriginatingORIID>
    <nh2:DestinationORIID>AZNLETS20</nh2:DestinationORIID>
    <nh2:MessageReceiveDate>10/06/2019</nh2:MessageReceiveDate>
    <nh2:MessageReceiveTime>16:55</nh2:MessageReceiveTime>
    <nh2:MessageSendDate>10/06/2019</nh2:MessageSendDate>
    <nh2:MessageSendTime>16:55</nh2:MessageSendTime>
    <nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
    <nh2:SendMessageNumeric>00281</nh2:SendMessageNumeric>
  </n2:NLETSMessageHeader>
  <n2:NLETSInquiryData n2:key="RCQ">
    <j:RoadwayRailwayCrossingIdentification xmlns:j="http://release.niem.gov/niem/domains/jxdm/5.0/">
      <nc:IdentificationID xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">012239W</nc:IdentificationID>
    </j:RoadwayRailwayCrossingIdentification>
  </n2:NLETSInquiryData>
  <n2:NLETSResponseData n2:key="RCR">
    <n2-rcr:RoadwayRailwayCrossing xmlns:n2-rcr="http://www.nlets.org/niem/nlets-railroad-crossing/1.0">
      <j:RoadwayRailwayCrossingIdentification xmlns:j="http://release.niem.gov/niem/domains/jxdm/5.0/">
        <nc:IdentificationID xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">012239W</nc:IdentificationID>
      </j:RoadwayRailwayCrossingIdentification>
      <n2-rcr:RoadwayRailwayCrossingLocation>
        <nc:Address xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <nc:LocationStreet>
            <nc:StreetName>US HWY 77</nc:StreetName>
          </nc:LocationStreet>
          <nc:LocationCityName>PURCELL</nc:LocationCityName>
          <nc:LocationCountyName>MCCLAIN</nc:LocationCountyName>
          <nc:LocationStateFIPS5-2AlphaCode>OK</nc:LocationStateFIPS5-2AlphaCode>
          <nc:LocationStateFIPS5-2AlphaCode>OK</nc:LocationStateFIPS5-2AlphaCode>
        </nc:Address>
        <nc:AddressHighway xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <nc:HighwayAugmentationPoint xsi:type="n2-rcr:HighwayAugmentationType" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <n2-rcr:HighwayTypeText>US 77</n2-rcr:HighwayTypeText>
          </nc:HighwayAugmentationPoint>
        </nc:AddressHighway>
        <nc:LocationDescriptionText xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">IN CITY</nc:LocationDescriptionText>
        <nc:Location2DGeospatialCoordinate xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <nc:GeographicCoordinateLatitude>
            <nc:LatitudeDegreeValue>0</nc:LatitudeDegreeValue>
            <nc:LatitudeMinuteValue>0</nc:LatitudeMinuteValue>
            <nc:LatitudeSecondValue>0</nc:LatitudeSecondValue>
          </nc:GeographicCoordinateLatitude>
          <nc:GeographicCoordinateLongitude>
            <nc:LongitudeDegreeValue>0</nc:LongitudeDegreeValue>
            <nc:LongitudeMinuteValue>0</nc:LongitudeMinuteValue>
            <nc:LongitudeSecondValue>0</nc:LongitudeSecondValue>
          </nc:GeographicCoordinateLongitude>
          <nc:Location2DGeospatialCoordinateAugmentation xsi:type="n2-rcr:Location2DGeospatialCoordinateAugmentationType" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <n2-rcr:CoordinateSourceText>ACTUAL</n2-rcr:CoordinateSourceText>
          </nc:Location2DGeospatialCoordinateAugmentation>
        </nc:Location2DGeospatialCoordinate>
        <nc:LocationAugmentationPoint xsi:type="n2-rcr:LocationAugmentationType" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <n2-rcr:LocationRailroadMilepostText>041720</n2-rcr:LocationRailroadMilepostText>
        </nc:LocationAugmentationPoint>
      </n2-rcr:RoadwayRailwayCrossingLocation>
      <n2-rcr:RailroadOperatingCompany>
        <nc:OrganizationEmergencyContactInformation xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <nc:ContactTelephoneNumber>
            <nc:FullTelephoneNumber>
              <nc:TelephoneNumberFullID>8173521549</nc:TelephoneNumberFullID>
            </nc:FullTelephoneNumber>
          </nc:ContactTelephoneNumber>
        </nc:OrganizationEmergencyContactInformation>
        <nc:OrganizationIdentification structures:id="7400" xmlns:structures="http://release.niem.gov/niem/structures/3.0/" xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/" />
        <nc:OrganizationName xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">BNSF RAILWAY COMPANY</nc:OrganizationName>
      </n2-rcr:RailroadOperatingCompany>
      <n2-rcr:NearestRailroadTimetableStationText>PURCELL</n2-rcr:NearestRailroadTimetableStationText>
      <n2-rcr:BranchNameText>ARK CITY-GAINSV</n2-rcr:BranchNameText>
      <n2-rcr:CrossingTypeText>PUBLIC VEHICLE</n2-rcr:CrossingTypeText>
      <n2-rcr:CrossingPositionText>RR UNDER</n2-rcr:CrossingPositionText>
      <n2-rcr:CrossingLowFrequencyIndicator>true</n2-rcr:CrossingLowFrequencyIndicator>
      <n2-rcr:CrossingOtherRailroadsSeparateTrackIndicator>false</n2-rcr:CrossingOtherRailroadsSeparateTrackIndicator>
      <n2-rcr:CrossingWarningDeviceDescriptionText>NO SIGNS OR SIGNALS</n2-rcr:CrossingWarningDeviceDescriptionText>
      <n2-rcr:CrossingTrainSignalIndicator>true</n2-rcr:CrossingTrainSignalIndicator>
      <n2-rcr:CrossingTrainDetectionIndicator>false</n2-rcr:CrossingTrainDetectionIndicator>
      <n2-rcr:CrossingNearbyHighwayIndicator>false</n2-rcr:CrossingNearbyHighwayIndicator>
      <n2-rcr:CrossingStateHighwayOrganization>
        <nc:OrganizationEmergencyContactInformation xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <nc:ContactTelephoneNumber>
            <nc:FullTelephoneNumber>
              <nc:TelephoneNumberFullID>4055214203</nc:TelephoneNumberFullID>
            </nc:FullTelephoneNumber>
          </nc:ContactTelephoneNumber>
        </nc:OrganizationEmergencyContactInformation>
      </n2-rcr:CrossingStateHighwayOrganization>
      <n2-rcr:CrossingOwnerOrganization>
        <nc:OrganizationEmergencyContactInformation xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
          <nc:ContactTelephoneNumber>
            <nc:FullTelephoneNumber>
              <nc:TelephoneNumberFullID>8008325452</nc:TelephoneNumberFullID>
            </nc:FullTelephoneNumber>
          </nc:ContactTelephoneNumber>
        </nc:OrganizationEmergencyContactInformation>
      </n2-rcr:CrossingOwnerOrganization>
    </n2-rcr:RoadwayRailwayCrossing>
  </n2:NLETSResponseData>
</n2:NLETS>