get
/api/v2/origin-destination/closed-matrix/{id}/time-series
Python SDK method:
client.origin_destination.closed_matrix(id=job_id).time_series_results()

Get closed OD matrix time-series results

Returns paginated time-series journey metric rows for a completed closed OD time-series child analysis. Each row represents one O/D pair at one aggregation-unit bucket. To generate time series, set generateTimeSeries parameter to true on the original analysis along with aggregationUnits.

Altitude Help Center — Closed OD API

Input Parameters

NameLocationTypeValuesDescriptionValue Required
idpathstring-Unique resource identifier.Y
pageTokenquerystring-Pagination token returned in the Link header of a previous response. Omit to fetch the first page.N

Success Responses

200 response: object

Paginated result data. When more pages are available, a Link: rel="next" header and Altitude-* pagination headers are included in the response.

NameTypeDescription
aggregationDateRangesarray<object>Date ranges included in the aggregation.
aggregationUnitstringTime aggregation unit.
aggregationValuestringTime aggregation bucket value.
destinationCodestringRaw destination zone code (e.g. county FIPS, ZIP code, custom zone ID).
destinationIdstringEncoded destination zone identifier for use in subsequent API requests.
destinationNamestringDestination zone description.
destinationTypestringDestination zone type.
destination_iso_3166_2stringISO 3166-2 state/province code of the destination zone.
durationAtDestinationAvgnumber (double)Average duration at destination (minutes).
durationAtDestinationMednumber (double)Median duration at destination (minutes).
interTripStopDurationAvgnumber (double)Average inter-trip stop duration (minutes).
interTripStopDurationMednumber (double)Median inter-trip stop duration (minutes).
journeyCountinteger (int64)Observed journey count.
journeyDistanceAvgnumber (double)Average journey distance (miles or kilometers, according to isMetric).
journeyDistanceMednumber (double)Median journey distance (miles or kilometers, according to isMetric).
journeyDurationAvgnumber (double)Average journey duration (minutes).
journeyDurationMednumber (double)Median journey duration (minutes).
originCodestringRaw origin zone code (e.g. county FIPS, ZIP code, custom zone ID).
originIdstringEncoded origin zone identifier for use in subsequent API requests.
originNamestringOrigin zone description.
originTypestringOrigin zone type.
origin_iso_3166_2stringISO 3166-2 state/province code of the origin zone.
zonePairIdstringOrigin-destination zone pair identifier.

Response Errors

HTTP Status CodeReason
400The request body or parameters are invalid.
401Authentication is required or the provided credentials are invalid.
403The authenticated user lacks permission to perform this operation.
404The requested resource does not exist.
409Result not yet ready. Poll the status monitor.
429The request rate limit has been exceeded.
500An unexpected server error occurred.