Aggregates

Aggregates refer to historical, pre-computed statistics and counts of events that occur at specific curbside locations, summarized on an hourly basis. These aggregates provide a consolidated view of event activity over time, helping to identify trends and patterns in curb usage. The data used to generate these aggregates is derived from sessions recorded in the system, which captures detailed information about individual events. By analyzing these hourly aggregates, cities and organizations can gain insights into curbside activities, such as peak usage times, frequency of events, and overall trends, which can inform planning and operational strategies.

Query Aggregates

get

Retrieve aggregate metrics data within specified parameters.

Query parameters

curbiq_tokenstringrequired

Required for client authentication to query the database.

curb_place_typestringoptional

CDS
The type of curb place this aggregate applies to from the Curbs API: area, zone, space.

curb_place_idstring · UUIDoptional

CDS
The ID of this curb place.

metric_typestringoptional

CDS
The metric this aggregate applies to: total_sessions, turnover, average_dwell_time, occupancy_percent

latnumber · floatoptional

CDS
Latitude at the center of the search circle.
This parameter is conditionally required if either 'lng' or 'radius' is specified.

lngnumber · floatoptional

CDS
Longitude at the center of the search circle.
This parameter is conditionally required if either 'lng' or 'radius' is specified.

radiusnumber · floatoptional

CDS
Radius of the search circle.
This parameter is conditionally required if either 'lng' or 'radius' is specified.

min_latnumber · floatoptional

CDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

min_lngnumber · floatoptional

CDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

max_latnumber · floatoptional

CDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

max_lngnumber · floatoptional

CDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

start_timeinteger · int64optional

CDS
The Aggregates object will return all aggregates after this start_time.
This parameter takes a time in the Timestamp format Otherwise, the server should reply with 404 Not Found. Availability data (if supplied) will be returned as of this time.

Example: 1643130000000

end_timeinteger · int64optional

CDS
The Aggregates object will return all aggregates before this end_time.
This parameter takes a time in the Timestamp format Otherwise, the server should reply with 404 Not Found. Availability data (if supplied) will be returned as of this time.

Example: 1643130000000

response_sizeintegeroptional

CCDS
Default is 100. The maximum response size is 250.

page_numintegeroptional

CCDS
Page number for paginated responses, default is 1.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://v2.curbiq-curb-api.io/metrics/aggregates?curbiq_token=text'

200

400

200

No body

Successful response. Aggregates as comma-separated values.