Traffic

This plugin provides functionality to query the Google Directions API for traffic / direction info. All mappings to items need to be done via your own logic.

Forum thread to the plugin: https://knx-user-forum.de/forum/supportforen/smarthome-py/1048446-traffic-plugin-support-thread

Take care not to request the interface too often as there currently is only a limit of 2500 free requests / day. More information and API key see: https://developers.google.com/maps/documentation/directions/intro?hl=de#traffic-model

Blog article to the plugin: https://www.smarthomeng.de/das-traffic-plugin-am-beispiel-eines-staualarms https://www.smarthomeng.de/geozonen-basierte-services-mit-der-egigeozone-app-und-dem-network-plugin https://www.smarthomeng.de/google-maps-widget-fuer-smartvisu-2-9

Requirements

This plugin requires lib requests. You can install this lib with:

sudo pip3 install requests --upgrade

Configuration

plugin.yaml

traffic:
    class_name: Traffic
    class_path: plugins.traffic
    apikey: your own api key
    language: de (optional)

Attributes

apikey: Your own personal API key for Google Directions. For your own key see https://developers.google.com/maps/documentation/directions/intro?hl=de#traffic-model
language: Any 2 char language code that is supported by Google Directions API, default is „de“

items.yaml

Currently, no pre defined items exist, the example below needs these items:

travel_info:

    travel_time:
        type: num

        in_traffic:
            type: num

    travel_distance:
        type: num

    travel_summary:
        type: str

    html_instructions:
        type: str

    html_warnings:
        type: str

    copyrights:
        type: str

    start_address:
        type: str

    start_location:

        lat:
            type: num

        lon:
            type: num

    end_address:
        type: str

    end_location:

        lat:
            type: num

        lon:
            type: num

Functions

get_route_info(origin, destination, alternatives, mode):

Returns route information for a provided origin (in the example home coordinates) and destination (in the example Berlin)

route = sh.traffic.get_route_info(sh._lat+','+sh._lon, 'Berlin', False, 'now', 'driving')

if route['summary'] is not '':
    route['summary'] += ": "

summary = route['summary'] + ": %.1f km in %.0f min" % (round(route['distance'] / 1000, 2), round(route['duration_in_traffic'] / 60, 2))
sh.travel_info.travel_time(route['duration'])
sh.travel_info.travel_time.in_traffic(route['duration_in_traffic'])
sh.travel_info.travel_distance(route['distance'])
sh.travel_info.travel_summary(summary)
sh.travel_info.html_instructions(route['html_instructions'])
sh.travel_info.html_warnings(route['html_warnings'])
sh.travel_info.copyrights(route['copyrights'])
sh.travel_info.start_address(route['start_address'])
sh.travel_info.start_location.lat(route['start_location_lat'])
sh.travel_info.start_location.lon(route['start_location_lon'])
sh.travel_info.end_address(route['end_address'])
sh.travel_info.end_location.lat(route['end_location_lat'])
sh.travel_info.end_location.lon(route['end_location_lon'])

Returned is a dict (or in case of alternatives = True an array of dicts) with route information. The following dict keys are available: distance (in meters), duration (in seconds), summary