Section 45: Railroad Crossing Transactions

From Nlets Wiki
Jump to: navigation, search

Railroad Crossing Transactions (RCQ/RCR)

This section describes the Railroad Crossing transactions which provide Nlets users with the location and type of railroad road crossing at a specific location.

The purpose of the Railroad Crossing transaction is to obtain pertinent information related to a railroad crossing, such as location and emergency contact phone numbers. The inquiry will be based upon a Railroad Crossing Identification number. The RCQ message key is run to destination "NL" on the Nlets system.

The response will include information on the location of the crossing, including geospatial coordinates, the operating company and other emergency contact phone numbers, and details about the crossing itself.

Railroad Crossing Specifications

XML Tag: Legacy
Prefix:
Field
Size:
Explanation
<j:RoadwayRailwayCrossingIdentification>
   <nc:IdentificationID>
RCI 1-10 unique US DOT/AAR number assigned to a
railroad crossing by the state's highway agency.

Top

GJXDM (DEPRECATED)

GJXDM has been deprecated. Please contact Nlets for additional assistance with GJXDM.

Top

NIEM

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>

Top

Legacy (DEPRECATED)

Railroad Crossing Legacy Specifications

This section provides the Legacy format and example of the Railroad Crossing transaction.

Railroad Crossing Specifications

Entry # Char. Explanation
RCI N/A unique US DOT/AAR number assigned to a
railroad crossing by the state's highway agency.
Railroad Crossing Legacy Examples

Example 1: Query of a Railroad Crossing transaction.

RCQ.AZNLETS20.NL.TXT
RCI/012239W

Example 2: Response on a Railroad Crossing query.

RCR.AZNLETS00 ?
16:25 12/12/2014 00029 ?
16:25 12/12/2014 00053 AZNLETS20 ?
TXT ?
Crossing Number 000447N ?
Location of Crossing ?
Highway ?
PIERCE ROAD NORTH STAR GRATIOTMI ?
NEAR CITY ?
Railroad Operating Company ?
GREAT LAKES CENTRAL RAILROAD 8006227245 ?
State Highway Emergency Contact 5173352592 ?
Crossing Owner Emergency Contact 5173352592 ? 
Additional Crossing Details ?
Crossing Nearby Highway: false ?
Crossing Type: PUBLIC VEHICLE ?
Crossing Position: AT GRADE UNDER ?
Crossing Category: ?
Warning Devices: CROSSBUCKS ?
Crossing not equipped with train signals ?
Crossing not equipped with train detection ?
Nearest Railroad Timetable Station: OWOSSO

Top

Downloads

Download RCQ Schema

Download RCR Schema

Download RCR Stylesheet

Top