100
credits
Per Pathcast call
Hourly
granularity
Traffic resolution
Veh+Ped
modes
Mode coverage
US
coverage
Path network
Pathcast is a calibrated traffic model. Basecast trajectories supply the input movement signal. DOT permanent counters supply the ground truth that calibrates Pathcast outputs. The query API returns hourly counts at the segment level, with direction and mode breakouts where the underlying signal supports them.
Every path response carries a provenance block plus a calibration_source field identifying the DOT counter or counters used for the segment.
What you get
- Hourly traffic measurements on any Motionworks path segment.
- Date-range historical traffic for trend and seasonality work.
- Path metadata with linkage back to the face and viewshed it feeds.
When to use this Job
- You are sizing pedestrian or vehicular movement for a new market study.
- You need historical traffic context for a retail-site or development decision.
- You are debugging an exposure model and want to verify traffic upstream of a viewshed.
How it works
- 1 Fetch a single path with
GET /pathcast/paths/{path_id}to get its geometry and metadata. - 2 Pull current hourly traffic with
GET /pathcast/paths/{path_id}/traffic. - 3 For trend analysis, pull a date range with
GET /pathcast/paths/{path_id}/history.
Primary endpoints
| Method | URL | Credits | Status | Summary |
|---|---|---|---|---|
| GET | https://api2.mworks.com/v2/pathcast/paths/{path_id}/traffic | 100 | production | Read hourly traffic for a path |
| GET | https://api2.mworks.com/v2/pathcast/paths/{path_id}/history | 100 | production | Read traffic history for a path |
| GET | https://api2.mworks.com/v2/pathcast/paths/{path_id} | 100 | production | Read one path |
GET /pathcast/paths/{path_id}/traffic getPathTraffic
| Name | In | Type | Required | Description |
|---|---|---|---|---|
path_id | path | string | Required | The path's `path_id`. |
year | query | integer | Optional | Calendar year to return. Omit for every available year. |
month | query | integer | Optional | Month to return (1–12). Omit for every month. |
day_type | query | integer | Optional | Day type: `1` Monday–Thursday, `2` Friday, `3` Saturday, `4` Sunday. Omit for all four. |
hour | query | integer | Optional | Local hour of day to return (0–23). Omit for all 24 hours. |
GET /pathcast/paths/{path_id}/history getPathHistory
| Name | In | Type | Required | Description |
|---|---|---|---|---|
path_id | path | string | Required | The path's `path_id`. |
start_date | query | string · date | Optional | First month to include (`YYYY-MM-DD`). |
end_date | query | string · date | Optional | Last month to include (`YYYY-MM-DD`). |
GET /pathcast/paths/{path_id} getPath
| Name | In | Type | Required | Description |
|---|---|---|---|---|
path_id | path | string | Required | The path's `path_id` (32 hex characters). |
Supporting endpoints
| Method | URL | Credits | Summary |
|---|---|---|---|
| GET | https://api2.mworks.com/v2/pathcast/faces/{place_id}/paths | 100 | List the paths for a face |
| GET | https://api2.mworks.com/v2/pathcast/faces/{place_id}/viewshed | 100 | Read a face's viewshed |