TomTom Traffic Commute

Get real-time commute traffic data using the TomTom Routing API. Returns distance, travel time with live traffic, delay minutes, and ETAs.

Setup

1. Get a TomTom API key — free tier at developer.tomtom.com (2,500 free transactions/day)
2. Set the environment variable: TOMTOM_API_KEY

Quick Start

export TOMTOM_API_KEY=yourkey
bash scripts/tomtom-traffic.sh "51.5081,-0.0753" "50.8213,-0.1325"

Usage

Basic query

export TOMTOM_API_KEY=yourkey
bash scripts/tomtom-traffic.sh <origin-lat,origin-lon> <dest-lat,dest-lon>

Query with departure time

export TOMTOM_API_KEY=yourkey
bash scripts/tomtom-traffic.sh "51.5081,-0.0753" "50.8213,-0.1325" "2026-06-09T06:45:00+01:00"

Output format

{
  "distance_km": 84.2,
  "travel_time_min": 63,
  "traffic_delay_min": 1,
  "traffic_affected_km": 1.1,
  "departure_time": "2026-06-05T10:43:27+01:00",
  "arrival_time": "2026-06-05T11:46:50+01:00",
  "summary": "84.2 km, 63 min (delay: 1 min)"
}

Automate with Cron

Optionally combine with AgentMail for daily commute email notifications. See examples/commute-email.sh for a complete workflow.

Scripts

| Script | Purpose | |--------|---------| | scripts/tomtom-traffic.sh | CLI tool — queries TomTom Routing API. No dependencies. | | examples/commute-email.sh | Optional: TomTom + AgentMail email workflow |

API Reference

Uses TomTom Routing API v1 /calculateRoute endpoint:

• Endpoint: https://api.tomtom.com/routing/1/calculateRoute/{origin}:{dest}/json
• Parameters: traffic=true, routeType=fastest
• Auth: API key in query string (key=)
• Free tier: 2,500 transactions/day
• Coordinates: lat,lon format (decimal degrees)
• Departure time: optional — defaults to "now"