get
/api/v2/poi/analytics/{id}/time-series
Python SDK method:
client.poi.analytics(id=job_id).time_series_results()

Get POI analytics time series results

Returns paginated time-series POI analytics rows for a completed POI analytics time-series child analysis. Each row represents aggregated POI analytics for one location at one aggregation-unit bucket. To generate time series, set generateTimeSeries parameter to true on the original analysis along with aggregationUnits.

Altitude Help Center — POI Location Specific Insights 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
aggregationUnitstringTime aggregation unit.
aggregationValuestringTime aggregation bucket value.
inputIdstringInput POI location identifier used to anchor the analysis.
inputNamestringInput POI location name used to anchor the analysis.
inputTypestringInput location type for the time-series row, typically POI.
input_iso_3166_2stringISO 3166-2 region code for the input POI location.
locationIdstringReturned POI location identifier.
locationNamestringReturned POI location name.
location_iso_3166_2stringISO 3166-2 region code for the returned POI location.
stopCountinteger (int64)Observed stop count.
stopCountByFuelTypearray<object>Stop count breakdown by fuel type.
stopCountByVehicleClassarray<object>Stop count breakdown by vehicle class.
stopCountByVocationarray<object>Stop count breakdown by vocation.
stopDurationAvgnumber (double)Average stop duration (minutes).
stopDurationBinsarray<object>Stop duration histogram buckets.
stopDurationMednumber (double)Median stop duration (minutes).

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.