This a module for the MagicMirror.
It shows your commute time using Google's Directions API (requires an API Key from Google).
It is a fork of jclarke0000's work
I started this fork because it seems Jeff Clarke has abondoned MMM-MyCommute, no recent updates and not mering PR's. I have merged the interesting changes I've found in other forks.
The module is a bit outdated, doesn't properly install on a new MagicMirror and doesn't live up to its expectations anymore. It's in need of a complete rewrite.
Support MMM-MyCommute rebuild
I'm looking for some moral support to start a complete rebuild.
The rebuild will be fully open source and free of charge.
Feature requests from contributors will be implemented (reasonably).
Donate here: https://gofund.me/b15bc3a0
Forward and share the Gofund.me as you see fit.
In a recent change the parameter apikey (no capitcal k) was renamed to apiKey (capital K). Please make sure, after updating you apply this change in your config.js too.
- Navigate into your MagicMirror
modulesfolder and executegit clone https://github.com/qistoph/MMM-MyCommute.git. - Enter the
MMM-MyCommutedirectory and executenpm install. - Go to Google Maps devtools and get an API key.
- Enable Directions API.
- NOTE: After the free period you might need to enable billing.
- Restart MagicMirror
e.g.pm2 restart mm
According to the billing information: "you get $200 free usage every month for Maps, Routes, or Places. Based on the millions of users using our APIs today, most of them can continue to use Google Maps Platform for free with this credit."
The default polling time is once every 10 minutes. That would ammount to an average of 4464 requests per month (60 / 10 * 24 * 31 = 4464). For the Directions ($0.005/request) that totals to $22.32 per month. For Advanced Directions ($0.01/request) the total is $44.62 per month.
Advanced Directions are directions that use one or more of:
- Traffic Information
- More than 10 waypoints
- Waypoints optimization
The number of requests can easily be significantly reduced by using the startTime and endTime.
You now configure the header in the standard way instead using the headerText and showHeader parameters. So if your config looked like this before:
{
module: 'MMM-MyCommute',
position: 'top_left',
classes: 'default everyone',
config: {
showHeader: true,
headerText: 'Traffic',
...
}
}change it to this:
{
module: 'MMM-MyCommute',
position: 'top_left',
header: 'Traffic',
classes: 'default everyone',
config: {
...
}
}If you don’t want a header, then just omit it.
| Option | Description |
|---|---|
apiKey |
REQUIRED API Key from Google Type: string |
origin |
REQUIRED The starting point for your commute. Usually this is your home address. Type: stringThis is as you would see it Google Maps. Example: 65 Front St W, Toronto, ON M5J 1E6 |
startTime |
The start time of the window during which this module wil be visible. Type: stringMust be in 24-hour time format. Defaults to 00:00 (i.e.: midnight) |
endTime |
The end time of the window during which this module wil be visible. Type: stringMust be in 24-hour time format. Defaults to 23:59 (i.e.: one minute before midnight). |
hideDays |
A list of numbers representing days of the week to hide the module. Type: arrayValid numbers are 0 through 6, 0 = Sunday, 6 = Saturday. e.g.: [0,6] hides the module on weekends. |
showSummary |
Whether to show a brief summary of the route Type: booleanDefaults to true |
showUpdated |
Show when the last update completed Type: booleanDefault to true |
showUpdatedPosition |
Position where to show last update completed. Valid options are header or footer.Type: stringDefault to footer |
colorCodeTravelTime |
Whether to colour-code the travel time red, yellow, or green based on traffic. Type: booleanDefaults to true |
travelTimeFormat |
How the module should format your total travel time. Type: stringDefaults to m [min] (e.g. 86 min). Some other examples are h[h] m[m] (e.g.: 1h 26min), h:mm (e.g. 1:26). This uses the moment-duration-format plugin's templating feature. |
travelTimeFormatTrim |
How to handle time tokens that have no value. For example, if you configure travelTimeFormat as "hh:mm" but the actual travel time is less than an hour, by default only the minute portion of the duration will be rendered. Set travelTimeFormatTrim to false to preserve the hh: portion of the format (e.g.: 00:21). Valid options are "left", "right" (e.g.: 2:00 renders as 2), or false (e.g.: do not trim).Type: String or falseDefaults to "left". |
moderateTimeThreshold |
The amount of variance between time in traffic vs absolute fastest time after which the time is coloured yellow Type: floatDefaults to 1.1 (i.e.: 10% longer than fastest time) |
poorTimeThreshold |
The amount of variance between time in traffic vs absolute fastest time after which the time is coloured red Type: floatDefaults to 1.3 (i.e.: 30% longer than fastest time) |
nextTransitVehicleDepartureFormat |
For any transit destinations where showNextVehicleDeparture is true, this dictates how to format the next arrival time.Type: stringDefaults to [next at] h:mm a. |
pollFrequency |
How frequently, in milliseconds, to poll for traffic predictions. BE CAREFUL WITH THIS! We're using Google's free API which has a maximum of 2400 requests per day. Each entry in the destinations list requires its own request so if you set this to be too frequent, it's pretty easy to blow your request quota. Type: number.Defaults to 10 * 60 * 1000 (i.e.: 600000ms, or every 10 minutes) |
destinations |
An array of destinations to which you would like to see commute times. Type: array of objects.See below for destination options. |
showError |
Hides error message if false and renders the last result. This is meant to bypass short issues like a lost WiFi signal. Type: booleanDefault to true |
Each object in the destinations array can have the following parameters:
| Option | Description |
|---|---|
destination |
REQUIRED The address of the destination Type: string |
label |
REQUIRED How you would like this displayed on your MagicMirror. Type: string |
mode |
Transportation mode, one of the following: driving, walking, bicycling, transit.Type: stringDefaults to driving. |
transitMode |
If mode = transit you can additionally specify one or more of the following: bus, subway, train, tram, or rail.Type: string.Separate multiple entries with the | character (e.g.: "transitMode" : "bus|subway|tram"). Specifying railindicates that the calculated route should prefer travel by train, tram, light rail, and subway. Equivalenet to train|tram|subway |
showNextVehicleDeparture |
If mode = transit the time of the next departure of the first vehicle on your route will be displayed in the route summary. Only visible when showSummary = true.Type: boolean. |
waypoints |
If specified, it instructs Google to find the route that passes through the waypoints you specify. Type: string.Separate multiple entries with the | character. See Waypoints docs for details on how waypoints can be specified.NOTE: your waypoints will automatically be prefixed with via: so that they are not treated as stopovers. This can cause Google to plan an erratic route. if you find your time predictions are wildly overestimated, then try adjusting your waypoints. Intersections where you would normally make a turn on this roite usually work well (e.g.: Main St & Southwood Drive Toronto ON). |
avoid |
If specified, will instruct the Google API to find a route that avoids one or more of the following: tolls,highways,ferries,indoor.Type: string.Separate multiple entries with the | character (e.g.: "avoid" : "highways|tolls"). |
alternatives |
If specified, will instruct the Google API to provide times for alternate routes. Must be used with showSummary: trueType: boolean |
color |
If specified, the colour for the icon in hexadecimal format (e.g.: "#82BAE5")Type: stringDefaults to white. |
startTime |
The start time of the window during which this destination wil be visible. Type: stringMust be in 24-hour time format. Defaults to 00:00 (i.e.: midnight) |
endTime |
The end time of the window during which this destination wil be visible. Type: stringMust be in 24-hour time format. Defaults to 23:59 (i.e.: one minute before midnight). |
hideDays |
A list of numbers representing days of the week to hide the destination. Type: arrayValid numbers are 0 through 6, 0 = Sunday, 6 = Saturday. e.g.: [0,6] hides the destination on weekends. |
origin |
Optionally overide the global origin for a single destination. |
Here is an example of an entry in config.js
{
module: 'MMM-MyCommute',
position: 'top_left',
config: {
apiKey: 'API_KEY_FROM_GOOGLE',
origin: '65 Front St W, Toronto, ON M5J 1E6',
startTime: '00:00',
endTime: '23:59',
hideDays: [0,6],
destinations: [
{
destination: '14 Duncan St Toronto, ON M5H 3G8',
label: 'Air Canada Centre',
mode: 'walking',
color: '#82E5AA'
},
{
destination: '317 Dundas St W, Toronto, ON M5T 1G4',
label: 'Art Gallery of Ontario',
mode: 'transit'
},
{
destination: '55 Mill St, Toronto, ON M5A 3C4',
label: 'Distillery District',
mode: 'bicycling'
},
{
destination: '6301 Silver Dart Dr, Mississauga, ON L5P 1B2',
label: 'Pearson Airport',
avoid: 'tolls'
}
]
}
}Additionally MMM-MyCommute can show travel times to upcoming events in the default calendar module. The config can be extended with the following options. Routes will be shown for events with a location.
| Option | Description |
|---|---|
maxCalendarEvents |
Number of routes to show. Type: intDefaults to 0 |
maxCalendarTime |
Show routes only for appointments within this timeframe (in milliseconds). Type: intDefaults to 24 * 60 * 60 * 1000 (1 day) |
calendarOptions |
An array like the regular destinations. For each event all of these options are added as a route. All options from above can be used, except that label will be overwritten with the event subject and destination with the event location. maxLabelLength can be used to trim topics of appointments.Type: arrayDefaults to [{mode: 'driving', maxLabelLength: 25}] |
Here is an example of an entry in config.js including calendar event routes
{
module: 'MMM-MyCommute',
position: 'top_left',
config: {
apiKey: 'API_KEY_FROM_GOOGLE',
origin: '65 Front St W, Toronto, ON M5J 1E6',
destinations: [
{
destination: '14 Duncan St Toronto, ON M5H 3G8',
label: 'Air Canada Centre',
mode: 'walking',
color: '#82E5AA'
}
],
// Additional config for calendar routes:
maxCalendarEvents: 2,
calendarOptions: [
{
mode: 'driving'
},
{
mode: 'transit',
transitMode: 'train'
}
]
}
}If the module seems to malfunction or doesn't show any route information at all, here are some guidelines to help you fix it:
- Check the server side log of MagicMirror
- Check the client side log of your mirror
- Check the known issues
- Create a new issue, including a clear description of your problem and the relevant server and client logs
Installed during installation
- Jeff Clarke for creating MMM-MyCommute, this has inspired all my additional changes.
- Michael Teeuw for creating the awesome MagicMirror2 project that made this module possible.
- Dominic Marx for creating the original mrx-work-traffic that this module heavily borrows upon.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent