Traffic Web Services - Traffic REST API

Request URL

http://local.yahooapis.com/MapsService/V1/trafficData

Request parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
street	string	Street name. The number is optional.
city	string	City name.
state	string	The United States state. You can spell out the full state name or you can use the two-letter abbreviation.
zip	integer or <integer>-<integer>	The five-digit zip code, or the five-digit code plus four-digit extension. If this location contradicts the city and state specified, the zip code will be used for determining the location and the city and state will be ignored.
location	free text	This free field lets users enter any of the following: city, state city, state, zip zip street, city, state street, city, state, zip street, zip If location is specified, it will take priority over the individual fields in determining the location for the query. City, state and zip will be ignored.
latitude	float: -90 to 90	The latitude of the starting location.
longitude	float: -180 to 180	The longitude of the starting location. If both latitude and longitude are specified, they will take priority over all other location data. If only one of latitude or longitude is specified, both will be ignored.
severity	integer: 1 to 5 (default: 1)	The minimum severity level to return, from 1 (least severe) to 5 (most severe)
zoom	integer: 1 to 12 (default: 6)	The zoom level for the data, from 1 (street level) to 12 (country level). If a radius is specified, this is ignored.
radius	float	How far (in miles) from the specified location to provide data for. The default radius varies according to the location given and the zoom level. If a zoom is specified, this is ignored.
include_map	0 (default) or 1	If set to 1 will return the URL of a map image for the location of each reported incident.
image_type	png (default) or gif	The image format for the map (if requested).
image_height	integer: 10 to 2000 (default: 500)	The height of the image (if requested) being generated, in pixels.
image_width	integer: 10 to 2000 (default: 620	The width of the image (if requested) being generated, in pixels.
output	string: xml (default), php	The format for the output. If php is requested, the results will be returned in Serialized PHP format.

Sample Request Url: http://local.yahooapis.com/MapsService/V1/trafficData?appid=YD-XYEUXak_JXzY7lo8FC1fSg--&street=701+First+Street&city=Sunnyvale&state=CA

Response Elements

The schema document for this service response is located at http://local.yahooapis.com/MapsService/V1/TrafficDataResponse.xsd

Field	Description
ResultSet	Contains all of the query responses.
LastUpdateDate	The last time data for this location was updated, in unix timestamp format.
Warning	If there is an issue with the associated map images (such as the exact location not being found), this will contain a brief warning about the problem.
Result	Contains each individual response. Has an attribute: type: The nature of the alert. Possible values are incident and construction.
Title	The general title of the alert.
Description	A more detailed description of the alert.
Latitude	The latitude of the location.
Longitude	The longitude of the location.
Direction	The direction of traffic flow affected by the alert.
Severity	The severity of the alert, from 1 (least severe) to 5 (most severe).
ReportDate	The date and time this incident was reported, in unix timestamp format.
UpdateDate	The date and time this incident was last updated, in unix timestamp format.
EndDate	The date and time this incident is scheduled to end, in unix timestamp format.
ImageUrl	If requested, the URL for an image corresponding to the location of the alert.

Sample response

The following is a sample response for the traffic problems around Yahoo! headquarters:

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:maps" xsi:schemaLocation="urn:yahoo:maps http://local.yahooapis.com/MapsService/V1/TrafficDataResponse.xsd">
  <LastUpdateDate>1129338729</LastUpdateDate>
  <Result type="construction">
    <Title>Road construction, on US-101 at MIDDLEFIELD RD</Title>
    <Description>SOUTHBOUNDFULL HIGHWAY CLOSURE DEMOLITION</Description>
    <Latitude>37.413201</Latitude>
    <Longitude>-122.081322</Longitude>
    <Direction>N/A</Direction>
    <Severity>2</Severity>
    <ReportDate>1129363260</ReportDate>
    <UpdateDate>1129333620</UpdateDate>
    <EndDate>1129381260</EndDate>
  </Result>
  <Result type="construction">
    <Title>Road construction, on US-101 at MOFFETT BLVD</Title>
    <Description>NORTHBOUNDFULL HIGHWAY CLOSURE CONSTRUCTION</Description>
    <Latitude>37.407215</Latitude>
    <Longitude>-122.065064</Longitude>
    <Direction>N/A</Direction>
    <Severity>2</Severity>
    <ReportDate>1129363260</ReportDate>
    <UpdateDate>1129333620</UpdateDate>
    <EndDate>1129381260</EndDate>
  </Result>
</ResultSet>

Rate Limit

The Traffic Web Service is limited to 50,000 queries per IP address per day. See information on rate limiting.

Errors

The Traffic Web Service returns the standard errors. There are no service-specific errors.