query API for network statistics

[drewda]

The Datastore API will support a range of live queries for simple analysis of roadway network statistics.

The Datastore API will offer similar functionality to the existing POC's Traffic Engine API, which is partially documented at https://github.com/WorldBank-Transport/traffic-engine-app/wiki/Functionality-Overview

(Note the Datastore API will also offer an endpoint for traffic-influenced routing in the future--that work be fleshed out under another issue.)

query parameters to accept for the network statistics API endpoint:

• bounding box for geographic extent [required]
• start datetime and end datetime for temporal extent [optional]
• array of one or more days-of-week (Monday, Tuesday, etc.) to filter results by day(s) [optional]
• array of one or more hours-of-day (00:00, 01:00, 02:00, etc.) to filter results by hour(s) [optional]
• comparison start datetime and comparison end datetime, when comparing between two temporal extents [optional]

The only query parameter that should be required is bounding box. All temporal query parameters are optional.

response contents:

• geometries (as GeoJSON)
• overall average speed per segment across entire temporal extent
• average speed per segment by hour + day per week (to power bar charts)
• observation count per segment by hour + day per week (only for authorized users)
• When comparing across two different timeframes, also:
  • significance figure from a two-sample paired t-test
  • percentage change in speed by day of week + hour of day (to power bar charts)