Repository navigation
v1.0.0
👋 TomTom's traffic reports in Home Assistant. Jams, closed roads and lanes, roadworks, accidents and the weather on the road - for an area, a circle that follows a device tracker, or a route. Every report is a geo_location entity on the map, with its road, the stretch it covers and a ready-made one-line summary.
✨ What's in it
🚗 Live routes. Worked out again on every poll with the traffic of the moment: the fastest way right now, its travel time and delay as sensors, and the reports on exactly that way. The way back as a second entry, each with hours of its own.
🗺️ A dashboard card of its own. The reports as a list under a map, side by side, or one line with a pop-up; each report's stretch drawn on the road; a route's travel time large under the title, green, yellow or red by its delay. Comes with the integration and is set up entirely in the visual editor - no YAML, no card-mod.
🚦 Traffic flow on the map. TomTom's flow tiles over the card's map while it is on screen, served through the integration so the key never reaches the browser.
🧭 Plan a route on the card. Start, stops and destination, the route and its reports on the map, then save it as a route entry.
📷 Speed cameras from blitzer.de and Lufop. Optional further sources, off until you switch them on.
🔔 Report Alerts blueprint. A message for every new report, or a digest of everything standing - to your phone, the notification bell, a speaker or anything else. Installed with the integration.
📊 The free tier in sight. Request counters per API, and a repair plus the Quota at risk sensor before a month's free requests run out.
🌍 30 languages - AI-translated apart from English and German. Corrections are welcome as pull requests.
🚀 Getting started
- In HACS, add
https://github.com/somansch/tomtomas a custom repository of type Integration, download TomTom and restart Home Assistant. - Get a free key at developer.tomtom.com - no payment method needed.
- Settings → Devices & Services → Add Integration → TomTom, paste the key and add your first area or route.
Needs Home Assistant 2024.7 or newer. Polling hourly, an area uses about 720 of the 2,500 free Incident Details requests a month.