Available Metrics
StreetLight Advanced Traffic Counts API
You can access multiple types of metrics on-demand with the StreetLight Advanced Traffic Counts API. Metrics are included for each road segment within the geometry you define in your metrics
query. The metrics below are available to be queried.
Each metric requested in the fields
parameter of the metrics
call is returned as one or more columns for each segment in the response.
Segments queried in calls to the Metrics endpoint count against your segment quota. All Advanced Traffic Counts users can query the Base Metrics below. Users with Plus subscriptions can query the Plus Metrics below.
If you would like to change your subscription, contact your StreetLight representative.
For metrics that are only available for specific data sources, these data sources are listed in the description of the metric. You specify the data source as a parameter in the request to the Metrics endpoint. For more information in the StreetLight Help Center, see What are data sources? .
Base Metrics
mode
The mode of travel described by the metrics.
country_code
The country where your geometry is located. Metrics are currently available for U.S. geographies.
segment_id (required)
Unique identifier for each segment.
match_dir
Whether the direction of traffic matches the road segment direction.
1
: Traffic flows with the segment’s direction2
: Traffic flows against the segment’s direction3
: Traffic is bi-directional
year_month
The year and month of the metrics in the row.
vmt
Vehicle Miles Traveled (VMT), calculated as trip volume*segment length.
trips_volume
The estimated trip counts in the segment as calculated by StreetLight’s algorithms.
trips_sample_count
The number of real world trips in our sample on which metrics are based.
day_type
1..7
: Day of the week-1
= Weekday-2
= Weekend-3
= All days
day_part
Segments of the day defined in intervals of hours to analyze traffic.
0..23
: Hour of the day, where 0 is from 12:00 AM - 1:00 AM-1..-8
= 3 hour bins, where 1 is from 12:00 AM - 3:00 AM-10
= all day
Plus Metrics
Trip Attributes
max_1_hr_speed
The maximum 1-hour-average-speed in a month.
avg_speed
The average speed in mph for the full length of trips that pass through the segment.
start_distance
Distance from the segment to the start of each trip that passes through it.
The following ranges are returned for pedestrian queries:
start_dist_lt025
: Trips that start less than 1/4 mi from the segmentstart_dist_025_05
: Trips that start between 1/4 mi to 1/2 mi from the segmentstart_dist_05_075
: Trips that start 1/2 mi to 3/4 mi from the segmentstart_dist_075_1
: Trips that start 3/4 mi to 1 mi from the segmentstart_dist_1_2
: Trips that start 1 to 2 mi from the segmentstart_dist_gt2
: Trips that start over 2 mi from segment
The following ranges are returned for vehicle queries:
start_dist_lt05
: Trips that start less than 1/2 mi from the segmentstart_dist_05_1
: Trips that start between 1/2 mi to 1 mi from the segmentstart_dist_1_2
: Trips that start 1 mi to 2 mi from the segmentstart_dist_2_5
: Trips that start 2 mi to 5 mi from the segmentstart_dist_5_10
: Trips that start 5 to 10 mi from the segmentstart_dist_10_25
: Trips that start 10 to 25 mi from the segmentstart_dist_25_50
: Trips that start 25 to 50 mi from the segmentstart_dist_50_100
: Trips that start 50 to 100 mi from the segmentstart_dist_gt100
: Trips that start over 100 mi from segment
end_distance
Distance from the segment to the end of each trip that passes through it.
The following ranges are returned for pedestrian queries:
end_dist_lt025
: Trips that end less than 1/4 mi from the segmentend_dist_025_05
: Trips that end between 1/4 mi to 1/2 mi from the segmentend_dist_05_075
: Trips that end 1/2 mi to 3/4 mi from the segmentend_dist_075_1
: Trips that end 3/4 mi to 1 mi from the segmentend_dist_1_2
: Trips that end 1 to 2 mi from the segmentend_dist_gt2
: Trips that end over 2 mi from segment
The following ranges are returned for vehicle queries:
end_dist_lt05
: Trips that end less than 1/2 mi from the segmentend_dist_05_1
: Trips that end between 1/2 mi to 1 mi from the segmentend_dist_1_2
: Trips that end 1 mi to 2 mi from the segmentend_dist_2_5
: Trips that end 2 mi to 5 mi from the segmentend_dist_5_10
: Trips that end 5 to 10 mi from the segmentend_dist_10_25
: Trips that end 10 to 25 mi from the segmentend_dist_25_50
: Trips that end 25 to 50 mi from the segmentend_dist_50_100
: Trips that end 50 to 100 mi from the segmentend_dist_gt100
: Trips that end over 100 mi from segment
home_distance
Distance from the segment to the home location of each trip that passes through it. Only available for the lbs_plus
data source.
The following ranges are returned for pedestrian queries:
home_dist_lt025
: Trips where the inferred home location is less than 1/4 mi from the segmenthome_dist_025_05
: Trips where the inferred home location is 1/4 mi to 1/2 mi from the segmenthome_dist_05_075
: Trips where the inferred home location is 1/2 mi to 3/4 mi from the segmenthome_dist_075_1
: Trips where the inferred home location is 3/4 mi to 1 mi from the segmenthome_dist_1_2
: Trips where the inferred home location is 1 to 2 mi from the segmenthome_dist_gt2
: Trips where the inferred home location is >2mi from the segment
The following ranges are returned for vehicle queries:
home_dist_lt05
: Trips where the inferred home location is less than 1/2 mi from the segmenthome_dist_05_1
: Trips where the inferred home location is 1/2 mi to 1 mi from the segmenthome_dist_1_2
: Trips where the inferred home location is 1 mi to 2 mi from the segmenthome_dist_2_5
: Trips where the inferred home location is 2 mi to 5 mi from the segmenthome_dist_5_10
: Trips where the inferred home location is 5 to 10 mi from the segmenthome_dist_10_25
: Trips where the inferred home location is 10 to 25 mi from the segmenthome_dist_25_50
: Trips where the inferred home location is 25 to 50 mi from the segmenthome_dist_50_100
: Trips where the inferred home location is 50 to 100 mi from the segmenthome_dist_gt100
: Trips where the inferred home location is over 100 mi from segment
work_distance
Distance from the segment to the work location of each trip that passes through it. Only available for the lbs_plus
data source.
The following ranges are returned for pedestrian queries:
work_dist_lt025
: Trips where the inferred work location is less than 1/4 mi from the segmentwork_dist_025_05
: Trips where the inferred work location is 1/4 mi to 1/2 mi from the segmentwork_dist_05_075
: Trips where the inferred work location is 1/2 mi to 3/4 mi from the segmentwork_dist_075_1
: Trips where the inferred work location is 3/4 mi to 1 mi from the segmentwork_dist_1_2
: Trips where the inferred work location is 1 to 2 mi from the segmentwork_dist_gt2
: Trips where the inferred work location is >2mi from the segment
The following ranges are returned for vehicle queries:
work_dist_lt05
: Trips where the inferred work location is less than 1/2 mi from the segmentwork_dist_05_1
: Trips where the inferred work location is 1/2 mi to 1 mi from the segmentwork_dist_1_2
: Trips where the inferred work location is 1 mi to 2 mi from the segmentwork_dist_2_5
: Trips where the inferred work location is 2 mi to 5 mi from the segmentwork_dist_5_10
: Trips where the inferred work location is 5 to 10 mi from the segmentwork_dist_10_25
: Trips where the inferred work location is 10 to 25 mi from the segmentwork_dist_25_50
: Trips where the inferred work location is 25 to 50 mi from the segmentwork_dist_50_100
: Trips where the inferred work location is 50 to 100 mi from the segmentwork_dist_gt100
: Trips where the inferred work location is over 100 mi from segment
For more information in the StreetLight Help Center, see Home and Work Location Methodology .
speed
Distribution of vehicle speeds in 5 mph ranges.
Traveler Attributes
Traveler Attributes are only available for the lbs_plus
data source.
For more information in the StreetLight Help Center, see Traveler Attributes .
trip_purpose
- hbw (Home Based Work): Percent of trips with a home based work trip purpose
- nhbw (Not Home Based Work)): Percent of trips that do not have a home based work trip purpose. (1 - hbw = nhbw)
- hbo (Home Based Other): Percent of trips that have a home based other trip purpose
- wbo (Work Based Other): Percent of trips that have a work based other trip purpose
income
Represents what household income bracket travelers are in. The ranges below are examples but more ranges are returned.
inc_lt_10k
: Proportion of travelers that make less than $10,000 annuallyinc_40_45k
: Proportion of travelers that make between $40,000 and $45,000 annuallyinc_gt_200k
: Proportion of travelers that make over $200,000 annually
education
Represents the highest education level of the head of the household for travelers.
edu_lt_9gr
: Proportion of travelers over the age of 25 of which the highest level of education is below high school completion (diploma not awarded).edu_9_12gr
: Proportion of travelers over the age of 25 of which the highest level of education is high school (but did not graduate).edu_highschool
: Proportion of travelers over the age of 25 of which the highest level of education is completion of high school.edu_some_college
: Proportion of travelers over the age of 25 of which the highest level of education is some college (but degree not awarded), including associate's degree.edu_associate
: Proportion of travelers over the age of 25 of which the highest level of education is the completion of an associate's college.edu_bachelor
: Proportion of travelers over the age of 25 of which the highest level of education is the completion of a bachelor's college.edu_graduate
: Proportion of travelers over the age of 25 of which the highest level of education is beyond completion of college.
race_ethnicity
Race represents the self-identified race of travelers.
white
: Proportion of travelers that self-identify as White.black
: Proportion of travelers that self-identify as Black or African American.indian
: Proportion of travelers that self-identify as American Indian or Alaska Native.asian
: Proportion of travelers that self-identify as Asian.islander
: Proportion of travelers that self-identify as Native Hawaiian or Other Pacific Islander.other_race
: Proportion of travelers that self-identify as Some Other Race.multiple_races
: Proportion of travelers that self-identify as Two or More Races.
Ethnicity represents whether travelers self-identify as Hispanic.
hispaniclatino
: Proportion of travelers that self-identify as of Hispanic or Latino Origin.nothispaniclatino
: Proportion of travelers that do not self-identify as of Hispanic or Latino Origin.
household
Family Status: This represents the household family status of travelers
hhkids_withkids
: Proportion of travelers that live in households with children.hhkids_nokids
: Proportion of travelers that live in households with no children.hhkids_lt6yr
: Proportion of travelers that live in households with children under the age of 6.hhkids_6to17
: Proportion of travelers that live in households with children between the ages of 6 and 17.
Vehicle Attributes
Vehicle attributes are only available for the cvd_plus
data source.
Vehicle attributes describe proportions of vehicles in the sample. To check trips in the sample, see trips sample count.
body_class
Proportion of vehicles that are the listed body class. The following body classes are measured:
body_class_coupe
body_class_cuv
body_class_hatchback
body_class_minivan
body_class_motor_home
body_class_other
body_class_pickup
body_class_sedan
body_class_supermini
body_class_suv
body_class_truck
power_train
power_train_ev
: Proportion of vehicles that are electric vehicles.power_train_hv
: Proportion of vehicles that are hybrid vehicles that use electric and gasoline power.power_train_ice
: Proportion of vehicles that have internal combustion engines.power_train_other
: Proportion of vehicles that do not fit into the above categories.
model_year
model_lt_2016
: Proportion of vehicles that are older than the 2016 model year.model_2016
tomodel_2022
: Proportion of vehicles from the listed model year.
Updated 18 days ago