Waze Travel Time
The waze_travel_time sensor provides travel time from the Waze.
Unit system is by default set to the metric system.
Configuration
To use this sensor in your installation, add the following sensor section to your configuration.yaml file:
# Example entry for configuration.yaml
sensor:
- platform: waze_travel_time
origin: Montréal, QC
destination: Québec, QC
region: 'US'
Configuration Variables
- origin
(string)(Required)
Enter the starting address or the GPS coordinates of the location (GPS coordinates has to be separated by a comma). You can also enter an entity id which provides this information in its state, an entity id with latitude and longitude attributes, or zone friendly name.
- destination
(string)(Required)
Enter the destination address or the GPS coordinates of the location (GPS coordinates has to be separated by a comma). You can also enter an entity id which provides this information in its state, an entity id with latitude and longitude attributes, or zone friendly name.
- region
(string)(Required)
Choose one of the available regions from ‘AU’, ‘EU’, ‘US’, ‘NA’ (equivalent to ‘US’) or ‘IL’.
- name
-
(string)(Optional)
A name to display on the sensor.
Default value:
Waze Travel Time
- incl_filter
(string)(Optional)
A substring that has to be present in the description of the selected route (a simple case-insensitive matching).
- excl_filter
(string)(Optional)
A substring that has to be NOT present in the description of the selected route (a simple case-insensitive matching).
- realtime
-
(boolean)(Optional)
If this is set to false, Waze returns the time estimate, not including current conditions, but rather the average travel time for the current time of day. The parameter defaults to true, meaning Waze will return real-time travel time.
Default value:
true
- units
(string)(Optional)
Set the unit of measurement for the sensor in metric or imperial, otherwise the default unit of measurement is the same as the unit set in
unit_system:.- vehicle_type
(string)(Optional)
Set the vehicle type for the sensor: car, taxi, or motorcycle, otherwise the default is car.
Example using dynamic destination
Using the flexible option to set a sensor value to the destination, you can setup a single Waze integration that will calculate travel time to multiple optional locations on demand.
In the following example, the Input Select is converted into an address which is used to modify the destination for Waze route calculation from device_tracker.myphone location (It takes a few minutes for the value to update due to the interval of Waze data fetching).
input_select:
destination:
name: destination
options:
- Home
- Work
- Parents
sensor:
- platform: template
sensors:
dest_address:
value_template: >-
{%- if is_state("input_select.destination", "Home") -%}
725 5th Ave, New York, NY 10022, USA
{%- elif is_state("input_select.destination", "Work") -%}
767 5th Ave, New York, NY 10153, USA
{%- elif is_state("input_select.destination", "Parents") -%}
178 Broadway, Brooklyn, NY 11211, USA
{%- else -%}
Unknown
{%- endif %}
# Tracking entity to entity
- platform: waze_travel_time
name: "Me to destination"
origin: device_tracker.myphone
destination: sensor.dest_address
region: 'US'
# Tracking entity to zone friendly name
- platform: waze_travel_time
name: Home To Eddie's House
origin: zone.home
destination: Eddies House # Friendly name of a zone
region: 'US'
# Tracking entity in imperial unit
- platform: waze_travel_time
origin: person.paulus
destination: "725 5th Ave, New York, NY 10022, USA"
region: 'US'
units: imperial # 'metric' for Metric, 'imperial' for Imperial
vehicle_type: motorcycle # vehicle type used for routing
Using the live map in an iFrame
If you plan to use Waze’s live map in Lovelace iframe then use https://embed.waze.com/iframe and not the live map URL itself.