511 NY Data Feed (Beta)

Introducing the 511 NY Data Feed


Welcome to the API documentation for 511NY. 511NY provides public data displayed on our website in easy-to-use XML format for third party web application developers to utilize in their own sites. The following documentation describes how to properly access this data and the different kinds available.

This data is available after you request and receive a user name and password from the 511NY project manager. See the 511NY Developer Access Agreement for instrucions.


CCTV XML Description

The CCTV data is accessed from http://www.511ny.org/NY511XMLFeeds/login.html. Each CCTV site contains a unique ID, textual location attribute, a latitude and longitude value, direction, status, URL to a CCTV image and various other information as described below. The data is returned in the following format:

<cctvs>
  <cctv>
    <CCTV_ID>1234567</CCTV_ID>
    <CCTV_Name>Belt Parkway @ Ocean Parkway</CCTV_Name>
    <Native_CCTV_ID>NULL</Native_CCTV_ID>
    <Owner_Name>NYC DOT - LIC</Owner_Name>
    <Description>Brooklyn</Description>
    <Direction>both</Direction>
    <Location>Belt Parkway @ Ocean Parkway</Location>
    <State>NY</State>
    <Latitude>40.123456</Latitude>
    <Longitude>-73.123456</Longitude>
    <Status>active</Status>
    <URL>http://www.cctvurl.com/xxxx.jpg</URL>
     <LastUpdated>4/18/2007 4:02:46 PM</LastUpdated>
  </cctv>
  <cctv>
    ...
  </cctv>
</cctvs>


Attribute Type Description
CCTV_ID integer Unique camera ID
CCTV_Name string Camera name
Native_CCTV_ID integer Native camera ID. Not always used.
Owner_Name string Camera owning agency.
Description string Camera location description.
Direction string Direction camera faces (Unknown, Northbound, Southbound, Eastbound, Westbound, Both, NorthSouth, EastWest).
Location string  Camera location.
State string State the camera is located in.
Latitude float Latitude location of the camera (signed floating point number).
Longitude float Longitude location of the camera (signed floating point number).
Status string Camera status (active, disabled, unknown).
URL string URL to the camera image.
LastUpdated datetime Date and time the camera data record (not video image) was last updated.


Event XML Description

The event data is accessed from http://www.511ny.org/NY511XMLFeeds/login.html. Each event contains information as described below. The data is returned in the following format:

<events>
  <event>
    <Event_ID>2009081320193306001</Event_ID>
    <EVENT_STATE</EVENT_STATE>
    <EVENT_CLASS>active construction</EVENT_CLASS>
    <EVENT_TYPE>road maintenance operations</EVENT_TYPE>
    <REPORT_ORG_ID>NYS Thruway Authority CAD</REPORT_ORG_ID>
    <FACILITY_NAME>I-87 - NYS Thruway</FACILITY_NAME>
    <DIRECTION>south</DIRECTION>
    <ARTICLE_CODE>in the vicinity of</ARTICLE_CODE>
    <FROM_LOC_POINT>Exit 23 (I-87) - Albany Downtown (I-787 - Rte 9W)</FROM_LOC_POINT>
    <TO_LOC_POINT>NULL</TO_LOC_POINT>
    <CREATE_TIME>8/13/2009 8:19:33 PM</CREATE_TIME>
    <LAST_UPDATE>8/13/2009 8:21:28 PM</LAST_UPDATE>
    <EVENT_DESCRIPTION>NYS Thruway Authority CAD: road maintenance operations on I-87 - NYS Thruway southbound from after Exit 23 (I-87) - Albany Downtown (I-787 - Rte 9W) to before Exit 23 (I-87) - Albany Downtown (I-787 - Rte 9W) until 6:00 AM, 08/14/09</EVENT_DESCRIPTION>
    <CITY>NULL</CITY>
    <COUNTY>Albany</COUNTY>
    <STATE>NY</STATE>
    <EST_DURATION>34800</EST_DURATION>
    <LAT>42.643875</LAT>
    <LON>-73.803985</LON>
    <TO_LAT>42.623245</TO_LAT>
    <TO_LON>-73.779137</TO_LON>
    <LANES_AFFECTED>0</LANES_AFFECTED>
    <LANE_STATUS>NULL</LANE_STATUS>
    <TOTAL_LANES>0</TOTAL_LANES>
    <LANE_DESCRIPTION>NULL</LANE_DESCRIPTION>
    <LANE_DETAIL>NULL</LANE_DETAIL>
    <UPDATE_NUMBER>2</UPDATE_NUMBER>
    <RESPOND_ORG_ID>CARS</RESPOND_ORG_ID>
    <PAVEMENT_CONDITION>NULL</PAVEMENT_CONDITION>
    <WEATHER_CODITION>NULL</WEATHER_CODITION>
    <START_DATE>NULL</START_DATE>
    <END_DATE>NULL</END_DATE>
    <EVENT_OTHER_DESC>NULL</EVENT_OTHER_DESC>
    <From_Mile_Marker>143.3</From_Mile_Marker>
    <To_Mile_Marker>141.2</To_Mile_Marker>
    <LOCAL_ONLY>False</LOCAL_ONLY>
    <CONSTRUCTION_TYPE>NULL</CONSTRUCTION_TYPE>
    <CONFIRMATION_CODE>NULL</CONFIRMATION_CODE>
    <CLOSURE_TYPE>0</CLOSURE_TYPE>
  </event>
  <event>
    ...
  </event>
</events>



Attribute Type Description
EVENT_ID string Unique ID of the event (19 character string).
EVENT_STATE string Whether the event is in the opened or updated state.
EVENT_CLASS string General event type description. Possible values are:

Incident
Transit Incident
Active Construction
Transit Active Construction
Construction
Transit Construction
Special Event
Active Highway Special Event
Active Special Event
Transit Special Event
Transit Active Special Event
EVENT_TYPE string Specific event type description.
REPORT_ORG_ID string Organization responsible for reporting the event.
FACILITY_NAME string Name of the facility affected by the event.
DIRECTION string Direction of traffic flow affected b the event.
ARTICLE_CODE string Descriptor corresponding to the from and to location. (ex. on, at, between)
FROM_LOC_POINT string Starting location of the event.
TO_LOC_POINT string Ending location of the event.
CREATE_TIME datetime Date and time the event was created.
LAST_UPDATE datetime Date and time the event was last updated.
EVENT_DESCRIPTION string Full event description containing detailed event information.
CITY string City location of the event.
COUNTY string County location of the event.
STATE string State location of the event.
EST_DURATION integer Number in seconds that the event is expected to be active for.
LAT float Starting latitude location of the event (signed floating point number).
LON float Starting longitude location of the event (signed floating point number).
TO_LAT float Ending latitude location of the event (signed floating point number).
TO_LON float Ending longitude location of the event (signed floating point number).
LANES_AFFECTED integer Number of lanes affected by the event.
LANE_STATUS string Lane status descriptor (ex. closed, blocked).
TOTAL_LANES integer Total number of lanes affected by the event.
LANE_DESCRIPTION string Lane descriptor (ex. 1 lane may be, right lane and shoulder, left and center lanes).
LANE_DETAIL string Detailed lane description (ex. local lanes, local and express roadways, express lanes).
UPDATE_NUMBER integer Number of times the event has been updated.
RESPOND_ORG_ID string Organizaion or application responsible for the event entry.
PAVEMENT_CONDITION string Condition of pavement where the event is located.
WEATHER_CODITION string Weather condition where the event is located.
START_DATE datetime Date and time the event is scheduled to begin.
END_DATE datetime Date and time the event is scheduled to close.
EVENT_OTHER_DESC string Other descriptive information about the event (ex. 15 minute delays, 2 mile delay).
From_Mile_Marker string Starting milemarker affected by the event on the facility affected by the event.
To_Mile_Marker string Ending milemarker affected by the event on the facility affected by the event.
LOCAL_ONLY boolean Indicates whether the event is local to a particular agency, or is seen agency-wide (always false).
CONSTRUCTION_TYPE string (ex. C,E,M,O,P)
CONFIRMATION_CODE string  
CLOSURE_TYPE integer Indicates the type of event closure. For internal use only.