Aggregated Histogram Statistics
Important Note
Explore ready-to-use traffic reports and data visualizations immediately by signing up for a 30-day free trial on the MOVE Portal. Once registered, you'll receive an API key to start using the Traffic Analytics APIs right away. Alternatively, you may contact our Sales team for a tailored solution.
Purpose
Aggregated histogram statistics provide batch trip statistics (durations, lengths, and average speeds) aggregated across all date/time range combinations defined in the analysis. Unlike the per-range histogram results, these files contain precomputed statistical summaries including percentiles, means, and standard deviations.
How to enable
To enable aggregated histogram statistics, set both of the following flags to true in the
analysis creation request body:
tripStats— enables histogram-based trip statistics.aggregatedTripStats— enables the aggregated statistics across all date/time ranges.
Both flags must be set to true. Setting aggregatedTripStats to true without tripStats will not produce aggregated results.
How to access
When the analysis reaches ACCEPTED status, the
preview endpoint response will include an aggregatedHistogramStats object at the top level, containing three download links:
durationsLink— aggregated durations statistics CSV.lengthsLink— aggregated lengths statistics CSV.avgSpeedsLink— aggregated average speeds statistics CSV.
Important: Download links are valid for 3 hours from the time of retrieval. Each new request to the preview endpoint generates fresh links. Do not cache or persist these URLs — always obtain a new link from the preview endpoint when you need to download the file.
CSV file format
Each of the three CSV files (durations, lengths, average speeds) follows the same structure. The file is comma-separated and contains one row per origin-destination-via combination.
CSV columns
Column | Description |
|---|---|
Origin | Origin region name. |
Destination | Destination region name. |
Via | Via region name. |
StartDate | Start date of the date range in YYYY-MM-DD format. |
EndDate | End date of the date range in YYYY-MM-DD format. |
DayType | Days of week included, semicolon-separated (e.g., MON;TUE;WED;THU;FRI;SAT;SUN ). |
Exclusions | Excluded dates, if any. |
StartTime | Start time of the time range in HH:mm format. |
EndTime | End time of the time range in HH:mm format. |
Unit | Unit of measurement. Depends on the file type:
|
TripCount | Total number of trips for this origin-destination-via combination. |
ArithmeticMean | Arithmetic mean of the measured values. |
HarmonicMean | Harmonic mean of the measured values. |
StdDev | Standard deviation of the measured values. |
P5 through P95 | Percentiles at 5% intervals: P5, P10, P15, P20, P25, P30, P35, P40, P45, P50, P55, P60, P65, P70, P75, P80, P85, P90, P95. |
CSV example
Origin,Destination,Via,StartDate,EndDate,DayType,Exclusions,StartTime,EndTime,Unit,TripCount,ArithmeticMean,HarmonicMean,StdDev,P5,P10,P15,P20,P25,P30,P35,P40,P45,P50,P55,P60,P65,P70,P75,P80,P85,P90,P95Region 1,Region 1,Region 1,2026-04-13,2026-04-19,MON;TUE;WED;THU;FRI;SAT;SUN,,10:00,20:00,KILOMETERS_PER_HOUR,126484,27.35,20.12,13.67,8.90,11.61,13.78,15.68,17.39,19.01,20.57,22.11,23.70,25.27,26.87,28.56,30.40,32.43,34.88,37.73,41.39,46.32,53.86
Methodology
The statistics in the aggregated histogram CSV files are computed from the underlying histogram data. For the calculation of means, standard deviations, and percentiles, the midpoint of each histogram interval is used as the representative value. For example, for a histogram interval of 5-10, the value 7.5 is used in the computation.
File types
File | Description |
|---|---|
| Durations | Trip duration statistics. Values are in |
| Lengths | Trip length statistics. Values are in |
| Average Speeds | Trip average speed statistics. Values are in |