Every state's Department of Transportation publishes road alerts. No two of them publish it the same way.

Washington answers in a REST API with an access code in the URL. Arizona and a handful of other states run on a shared platform called ibi511, keyed by an API key. Colorado answers in GeoJSON, with its coordinates ordered backward from most other feeds. Some states publish through WZDx, a federal open-data spec for work zones. Others run on plain ArcGIS map servers built for GIS software, not apps. A few small states have no dedicated traffic system at all, and their alerts live inside a general government open-data catalog instead.

MileCheck's server reads all of them and translates each one into the same shape: a route, a direction, a mile marker, a type of alert, a severity. A closure from Washington and a closure from Texas arrive in the app looking identical, because the translation already happened before either one reached your phone.

Route names alone will break a naive match

Arizona's alert system calls a road "101-LOOP." The mile marker data for that same road calls it "SR-101." Washington's incident feed drops the route number entirely for some conditions, and the real route has to be pulled out of a free-text location field instead. Every state gets its own small set of translation rules, built and tested against that state's actual data, because a rule that works for one platform can silently break on the next.

Sometimes the problem isn't data. It's infrastructure.

One state's system, Mississippi's, blocks the network range MileCheck's server runs on outright. The fix isn't clever: a separate small process fetches Mississippi's feed from a different network every half hour and stores the result somewhere MileCheck's server can read it.

What you actually see

This is the part of MileCheck a driver never sees and never should. What you get is one list of alerts, in one format, for a state you may be crossing for the first time. What it costs to produce that is a separate integration for every state that publishes one.

Keep reading

Related: How MileCheck finds your mile marker offline  ·  What happens when you cross a state line  ·  All 50 states