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 following metrics 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.
StreetLight charges for calls to the Metrics endpoint based on the number of StreetLight segments queried and the metrics fields requests. In the metrics below, an asterisk “*” notes metrics fields that are billable.
If you would like to enable quotas on the number of segments analyzed for your organization, contact your StreetLight representative.
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.
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
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.
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.
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_plusdata source. For more information, see What are data sources? .
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_plusdata source. For more information, see What are data sources? .
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
Only available for the
lbs_plusdata source. For more information, see What are data sources? .
For more information in the StreetLight Help Center about the following fields , see Traveler Attributes .
trip_purpose*
Represents whether travelers are making inferred Home-Based Work, Home-Based Other or Non-Home Based trips.
- Purpose HBW: Percent of travel that is home-based work (i.e. home-to-work or work-to-home).
- Purpose HBO: Percent of travel that is home-based other (i.e. from or to home, but not home-based work).
- Purpose NHB: Percent of travel that is not home-based (i.e. not from or to home).
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
Only available for the
cvd_plusdata source. For more information, see What are data sources? .
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_coupebody_class_cuvbody_class_hatchbackbody_class_minivanbody_class_motor_homebody_class_otherbody_class_pickupbody_class_sedanbody_class_superminibody_class_suvbody_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_2016tomodel_2022: Proportion of vehicles from the listed model year.
Updated about 1 month ago