Traffic Incident Data Source
The TrafficIncident data source contains information traffic incidents. You can query for traffic incidents in a specified area by using the Bing Spatial Data Services Query by Area API and the Query Near a Route API and any Bing Maps Key.
The following table describes the information provided for a traffic incident.
Property | Data Type | Description and Values |
|---|---|---|
IncidentId | Edm.String | A unique ID for the incident. Example: 210546697 |
Latitude | Edm.Double | The latitude of the incident. Example: 38.64829 |
Longitude | Edm.Double | The longitude of the incident. Example: -94.36405 |
LastModifiedUTC | Edm.DateTime | The time the incident information was last updated specified as a Coordinated Universal Time (UTC) time. Example: 2011-12-05T17:18:21.67Z |
StartTimeUTC | Edm.DateTime | The time the incident occurred specified as a Coordinated Universal Time (UTC) time.. Example: 2011-12-05T17:16:00Z |
EndTimeUTC | Edm.DateTime | The time that the traffic incident will end specified as a Coordinated Universal Time (UTC). Example: 2011-12-05T17:46:00Z |
Type | Edm.String | The type of incident specified by one of the following values.
Example: Accident |
Severity | Edm.String | The level of importance of incident specified by one of the following values.
Example: Minor |
Verified | Edm.Boolean | A value of true indicates that the incident has been visually verified or otherwise officially confirmed by a source like the local police department. Example: true |
RoadClosed | Edm.Boolean | A value of true indicates that there is a road closure. Example: false |
Description | Edm.String | A description of the incident. Examples:
|
DetourInfo | Edm.String | A description of a detour. Examples:
|
LaneInfo | Edm.String | A description specific to lanes, such as lane closures. Examples:
|
CongestionInfo | Edm.String | A description of the congestion. Examples:
|
ToPointLatitude | Edm.Double | The latitude of the point that specifies the end of a traffic incident, such as the end of a construction zone. Example: 38.65831 |
ToPointLongitude | Edm.Double | The longitude of the point that specifies the end of a traffic incident, such as the end of a construction zone. Example: -94.36706 |
You can query the TrafficIncidents data source by using the following base URL and specifying an area to search by using the Query by Area API or the Query Near a Route API.
Base Query URL
http://spatial.virtualearth.net/REST/v1/data/8F77935E46704C718E45F52D0D5550A6/TrafficIncidents/TrafficIncident
Query Example
The following query example queries for traffic incidents along a route from Houston, Texas to Galveston, Texas by using the Query Near a Route API. The query key you use can be any Bing Maps Key.
http://spatial.virtualearth.net/REST/v1/data/8F77935E46704C718E45F52D0D5550A6/TrafficIncidents/TrafficIncident?spatialFilter=nearRoute('Houston,TX','Galveston,Tx')&key=anyBingMapsKey
XML Response
This request returns traffic incident information in the following format.
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<title type="text"></title>
<id>uuid:e767cc8a-6932-4ec1-9b78-d2c36aa81989;id=45353</id>
<rights type="text">© 2012 Microsoft and its suppliers. This API and any results cannot be used or accessed without Microsoft's express written permission.</rights>
<updated>2012-02-01T19:08:15Z</updated>
<entry>
<id>https://spatial.virtualearth.net/REST/v1/data/8f77935e46704c718e45f52d0d5550a6/TrafficIncidents/TrafficIncident('277303858')</id>
<title type="text"></title>
<updated>2012-02-01T19:08:15Z</updated>
<content type="application/xml">
<m:properties>
<d:IncidentId>277303858</d:IncidentId>
<d:Latitude m:type="Edm.Double">29.378040</d:Latitude>
<d:Longitude m:type="Edm.Double">-95.020810</d:Longitude>
<d:LastModifiedUTC>2012-01-25T14:29:02.01Z</d:LastModifiedUTC>
<d:StartTimeUTC>2011-10-17T12:00:00Z</d:StartTimeUTC>
<d:EndTimeUTC>2012-02-12T14:00:00Z</d:EndTimeUTC>
<d:Type>Construction</d:Type>
<d:Severity>Minor</d:Severity>
<d:Verified>true</d:Verified>
<d:RoadClosed>true</d:RoadClosed>
<d:Description>FM-1765 is closed in both directions between Delaney Rd to FM-2004 - construction</d:Description>
<d:DetourInfo>follow the posted signage</d:DetourInfo>
<d:LaneInfo></d:LaneInfo>
<d:CongestionInfo></d:CongestionInfo>
<d:ToPointLatitude m:type="Edm.Double">0</d:ToPointLatitude>
<d:ToPointLongitude m:type="Edm.Double">0</d:ToPointLongitude>
<d:LocationCodes></d:LocationCodes>
</m:properties>
</content>
</entry>
<entry>
<id>https://spatial.virtualearth.net/REST/v1/data/8f77935e46704c718e45f52d0d5550a6/TrafficIncidents/TrafficIncident('277303880')</id>
<title type="text"></title>
<updated>2012-02-01T19:08:15Z</updated>
<content type="application/xml">
<m:properties>
<d:IncidentId>277303880</d:IncidentId>
<d:Latitude m:type="Edm.Double">29.769700</d:Latitude>
<d:Longitude m:type="Edm.Double">-95.358560</d:Longitude>
<d:LastModifiedUTC>2012-01-25T14:29:02.01Z</d:LastModifiedUTC>
<d:StartTimeUTC>2011-08-08T11:54:00Z</d:StartTimeUTC>
<d:EndTimeUTC>2012-10-01T22:00:00Z</d:EndTimeUTC>
<d:Type>Construction</d:Type>
<d:Severity>Minor</d:Severity>
<d:Verified>true</d:Verified>
<d:RoadClosed>true</d:RoadClosed>
<d:Description>N Main St is closed in both directions between Naylor St and Franklin St - construction</d:Description>
<d:DetourInfo>Follow posted signage</d:DetourInfo>
<d:LaneInfo></d:LaneInfo>
<d:CongestionInfo></d:CongestionInfo>
<d:ToPointLatitude m:type="Edm.Double">0</d:ToPointLatitude>
<d:ToPointLongitude m:type="Edm.Double">0</d:ToPointLongitude>
<d:LocationCodes></d:LocationCodes>
</m:properties>
</content>
</entry>
</feed>
JSON Response
When you specify $format=json in the URL, the response returns traffic incident information in the following JSON format.
{
"d":{
"__copyright":"\u00a9 2012 Microsoft and its suppliers. This API and any results cannot be used or accessed without Microsoft's express written permission.",
"results":[
{
"__metadata":{
"uri":"https:\/\/spatial.virtualearth.net\/REST\/v1\/data\/8f77935e46704c718e45f52d0d5550a6\/TrafficIncidents\/TrafficIncident('277303858')"
},
"IncidentId":"277303858",
"Latitude":29.378040,
"Longitude":-95.020810,
"LastModifiedUTC":"2012-01-25T14:29:02.01Z",
"StartTimeUTC":"2011-10-17T12:00:00Z",
"EndTimeUTC":"2012-02-12T14:00:00Z",
"Type":"Construction",
"Severity":"Minor",
"Verified":"true",
"RoadClosed":"true",
"Description":"FM-1765 is closed in both directions between Delaney Rd to FM-2004 - construction",
"DetourInfo":"follow the posted signage",
"LaneInfo":"",
"CongestionInfo":"",
"ToPointLatitude":0,
"ToPointLongitude":0,
"LocationCodes":""
},
{
"__metadata":{
"uri":"https:\/\/spatial.virtualearth.net\/REST\/v1\/data\/8f77935e46704c718e45f52d0d5550a6\/TrafficIncidents\/TrafficIncident('277303880')"
},
"IncidentId":"277303880",
"Latitude":29.769700,
"Longitude":-95.358560,
"LastModifiedUTC":"2012-01-25T14:29:02.01Z",
"StartTimeUTC":"2011-08-08T11:54:00Z",
"EndTimeUTC":"2012-10-01T22:00:00Z",
"Type":"Construction",
"Severity":"Minor",
"Verified":"true",
"RoadClosed":"true",
"Description":"N Main St is closed in both directions between Naylor St and Franklin St - construction",
"DetourInfo":"Follow posted signage",
"LaneInfo":"",
"CongestionInfo":"",
"ToPointLatitude":0,
"ToPointLongitude":0,
"LocationCodes":""
}
]
}
}