matt/central
1
0
Fork 0
mirror of https://github.com/zvx-echo6/central.git synced 2026-06-10 11:54:37 +02:00
Code Issues Projects Releases Packages Wiki Activity

v0.10.0: ITD 511 official API adapter (events + advisories + cameras) (#85)

Browse source 
First official-state-DOT-API pattern landing. Two adapters in one PR:

- itd_511 (event-class): polls Events (60s) + Advisories (300s) from
  https://511.idaho.gov/api/v2/get/{event,alerts}. Decodes EncodedPolyline
  to LineString via the polyline lib (bookend LineString or Point fallback);
  ITD Severity string mapped None->1 / Minor->2 / Major->3 with
  IsFullClosure=true forcing 3 regardless; RecurrenceSchedules /
  Restrictions / DetourPolyline pass through unmodified. Advisories ship
  as structural pass-through under data.advisory since the upstream
  /alerts endpoint currently returns []; per-record try/except keeps a
  surprise shape from sinking the cycle when ITD posts its first one.

- itd_511_cameras (telemetry-class): polls Cameras (600s). One event per
  camera per UTC day; image URL passes straight through to <img src>.
  Region uniform US-ID with data.source_jurisdiction preserving the raw
  upstream Source field for the ~1.2% cross-DOT border-region mirrors
  (UDOT / ODOT / WYDOT / WSDOT / NDot / MTD / DriveBC / Lemhi County).

Subject convention (v0.9.20 forward): central.traffic.<event_type>.us.id
and central.traffic_cameras.us.id.<camera_id>. Castle Rock state_511_atis
keeps its bare-state subject; consumers stay on central.traffic.>
wildcards during the A/B comparison window.

Retry predicate tightened from the Castle Rock / TomTom precedent: 5xx +
connection / timeout retry; 4xx other than 429 skip-with-warn (don't
burn quota on permanent errors); 429 honors Retry-After once then
retries. API key (alias 'idaho_511') travels in the ?key= query string,
so every error log path runs through self._redact() to scrub the URL.

Both adapters ship disabled; operator enables via GUI after registering
the API key with 'python -m set_api_key idaho_511'. Reuses existing
CENTRAL_TRAFFIC and CENTRAL_TRAFFIC_CAMERAS streams -- no archive
restart needed.

Scope-cap exception: this PR is ~1.5k lines vs. the standard 500-line
cap, authorized as a one-time exception for the first
official-state-DOT-API pattern landing. Two adapters + their tests +
real-API fixtures naturally exceed the v0.9.x adapter-cap budget.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
malice 2026-06-03 22:36:26 -06:00 • committed by GitHub
commit 1d5548c24c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
18 changed files with 1783 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

1
tests/fixtures/itd_511_alerts_sample.json vendored Normal file
View file

@ -0,0 +1 @@
[]

90
tests/fixtures/itd_511_cameras_sample.json vendored Normal file
View file

@ -0,0 +1,90 @@
[
{
"Id": 3,
"Source": "ITDNET",
"SourceId": "1000",
"Roadway": "SH-55 Eagle",
"Direction": "Southbound",
"Latitude": 43.619167,
"Longitude": -116.35478,
"Location": "SH-55 Eagle Fairview",
"SortOrder": 0,
"Views": [
{
"Id": 1039,
"Url": "https://511.idaho.gov/map/Cctv/1039",
"Status": "Disabled",
"Description": "D3 SH-55 37.9 Eagle Fairview 526"
}
]
},
{
"Id": 436,
"Source": "ACHD",
"SourceId": "4001",
"Roadway": "Local Boise",
"Direction": "Unknown",
"Latitude": 43.60304,
"Longitude": -116.18841,
"Location": "Park Parkcenter Front Clearwater",
"SortOrder": 0,
"Views": [
{
"Id": 631,
"Url": "https://511.idaho.gov/map/Cctv/631",
"Status": "Enabled",
"Description": ""
}
]
},
{
"Id": 1,
"Source": "UDOT",
"SourceId": "10.C1",
"Roadway": "I-15",
"Direction": "Unknown",
"Latitude": 42.0011,
"Longitude": -112.198,
"Location": "I-15 UT/ID State Line UT",
"SortOrder": 1,
"Views": [
{
"Id": 1,
"Url": "https://511.idaho.gov/map/Cctv/1",
"Status": "Enabled",
"Description": "N/A"
}
]
},
{
"Id": 2,
"Source": "RWIS",
"SourceId": "100.C1",
"Roadway": "SH-75",
"Direction": "Unknown",
"Latitude": 43.5946,
"Longitude": -114.345,
"Location": "SH-75 Wood River",
"SortOrder": 325,
"Views": [
{
"Id": 2,
"Url": "https://511.idaho.gov/map/Cctv/2",
"Status": "Enabled",
"Description": ""
},
{
"Id": 3,
"Url": "https://511.idaho.gov/map/Cctv/3",
"Status": "Enabled",
"Description": ""
},
{
"Id": 4,
"Url": "https://511.idaho.gov/map/Cctv/4",
"Status": "Enabled",
"Description": ""
}
]
}
]

214
tests/fixtures/itd_511_event_sample.json vendored Normal file
View file

@ -0,0 +1,214 @@
[
{
"ID": 23,
"SourceId": "4277",
"Organization": "ERS",
"RoadwayName": "SH-81",
"DirectionOfTravel": "Unknown",
"Description": " Work on the shoulder on SH-81 near Poverty Gulch. 7/8/2024 9:29 PM Mon: 12:00 PM - 5:00 PM, Tue, Wed, Thu, Fri, Sat, Sun: Active all day Activities: use caution, warning.",
"Reported": 1720495740,
"LastUpdated": 1749675731,
"StartDate": 1720495740,
"PlannedEndDate": null,
"LanesAffected": "No Data",
"Latitude": 42.5168038430856,
"Longitude": -113.711287649613,
"LatitudeSecondary": null,
"LongitudeSecondary": null,
"EventType": "roadwork",
"EventSubType": "workOnTheShoulder",
"IsFullClosure": false,
"Severity": "None",
"Comment": null,
"EncodedPolyline": null,
"Restrictions": {
"Width": null,
"Height": null,
"Length": null,
"Weight": null,
"Speed": null
},
"DetourPolyline": "",
"DetourInstructions": "",
"Recurrence": "<b>Mon:</b><br/>12:00 PM - 5:00 PM<br/><br/><b>Tue, Wed, Thu, Fri, Sat, Sun:</b><br/>Active all day<br/><br/>",
"RecurrenceSchedules": [
{
"StartDate": "7/8/2024 9:29:00 PM-06:00:00",
"EndDate": null,
"Times": [
{
"StartTime": "12:00:00-06:00:00",
"EndTime": "16:59:59-06:00:00"
}
],
"DaysOfWeek": [
"Monday"
]
},
{
"StartDate": "7/8/2024 9:29:00 PM-06:00:00",
"EndDate": null,
"Times": [
{
"StartTime": "00:00:00-06:00:00",
"EndTime": "23:59:59-06:00:00"
}
],
"DaysOfWeek": [
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
]
}
],
"Cause": "roadwork"
},
{
"ID": 17,
"SourceId": "469",
"Organization": "ERS",
"RoadwayName": "N McDermott Rd",
"DirectionOfTravel": "Both",
"Description": " Long term road construction on N McDermott Rd Both Directions from Five Mile Creek to US-20. All lanes closed. 1/30/2023 2:24 PM Mon, Tue, Wed, Thu, Fri, Sat, Sun: Active all day",
"Reported": 1675113840,
"LastUpdated": 1718758080,
"StartDate": 1675113840,
"PlannedEndDate": null,
"LanesAffected": "All lanes closed",
"Latitude": 43.6485700000001,
"Longitude": -116.47349,
"LatitudeSecondary": 43.6630000000001,
"LongitudeSecondary": -116.47421,
"EventType": "closures",
"EventSubType": "longTermRoadConstruction",
"IsFullClosure": true,
"Severity": "None",
"Comment": "Open to local traffic only.",
"EncodedPolyline": "qbliGhv{eUsk@MeTEsBAsAGiAQw@Qi@MoAYmA]aA]}@a@[?[JSNKNENCTEzCGnAIX",
"Restrictions": {
"Width": null,
"Height": null,
"Length": null,
"Weight": null,
"Speed": null
},
"DetourPolyline": "",
"DetourInstructions": "",
"Recurrence": "<b>Mon, Tue, Wed, Thu, Fri, Sat, Sun:</b><br/>Active all day<br/><br/>",
"RecurrenceSchedules": [
{
"StartDate": "1/30/2023 2:24:00 PM-06:00:00",
"EndDate": null,
"Times": [
{
"StartTime": "00:00:00-06:00:00",
"EndTime": "23:59:59-06:00:00"
}
],
"DaysOfWeek": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
]
}
],
"Cause": "roadwork"
},
{
"ID": 34585,
"SourceId": "11146",
"Organization": "ERS",
"RoadwayName": "I-84",
"DirectionOfTravel": "East",
"Description": " Left Lane Blocked on I-84 Eastbound near N Franklin Blvd. 2 Left Lanes Blocked. Activities: Expect Delays, Look Out for Flagger, Use Caution.",
"Reported": 1780543740,
"LastUpdated": 1780543820,
"StartDate": 1780543740,
"PlannedEndDate": null,
"LanesAffected": "2 Left Lanes Blocked",
"Latitude": 43.5980897425697,
"Longitude": -116.542818286917,
"LatitudeSecondary": null,
"LongitudeSecondary": null,
"EventType": "accidentsAndIncidents",
"EventSubType": "leftLaneBlocked",
"IsFullClosure": false,
"Severity": "None",
"Comment": "The two left lanes of eastbound I-84 will be blocked near milepost 36.5 tonight for road maintenance. Keep Right.",
"EncodedPolyline": null,
"Restrictions": {
"Width": null,
"Height": null,
"Length": null,
"Weight": null,
"Speed": null
},
"DetourPolyline": "",
"DetourInstructions": "",
"Recurrence": "",
"RecurrenceSchedules": "",
"Cause": "Incident"
},
{
"ID": 33663,
"SourceId": "11000",
"Organization": "ERS",
"RoadwayName": "SH-16",
"DirectionOfTravel": "Both",
"Description": " Special event on SH-16 Both Directions at W Chaparral Rd. 6/8/2026 8:00 AM to 6/15/2026 5:00 PM Mon, Tue, Wed, Thu, Fri, Sat, Sun: Active all day Activities: Use Caution.",
"Reported": 1780927200,
"LastUpdated": 1779805341,
"StartDate": 1780927200,
"PlannedEndDate": 1781564400,
"LanesAffected": "No Data",
"Latitude": 43.780078841046,
"Longitude": -116.473209123902,
"LatitudeSecondary": null,
"LongitudeSecondary": null,
"EventType": "specialEvents",
"EventSubType": "specialEvent",
"IsFullClosure": false,
"Severity": "None",
"Comment": "Rodeo Traffic entering/leaving roadway ",
"EncodedPolyline": null,
"Restrictions": {
"Width": null,
"Height": null,
"Length": null,
"Weight": null,
"Speed": null
},
"DetourPolyline": "",
"DetourInstructions": "",
"Recurrence": "<b>Mon, Tue, Wed, Thu, Fri, Sat, Sun:</b><br/>Active all day<br/><br/>",
"RecurrenceSchedules": [
{
"StartDate": "6/8/2026 8:00:00 AM-06:00:00",
"EndDate": "6/15/2026 5:00:00 PM-06:00:00",
"Times": [
{
"StartTime": "00:00:00-06:00:00",
"EndTime": "23:59:59-06:00:00"
}
],
"DaysOfWeek": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
]
}
],
"Cause": "specialEvents"
}
]