Smarthome mit FHEM: Fahrzeiten mit Verkehr mittels Google Maps API anzeigen

Nach langer Pause habe ich nun endlich mal wieder ein wenig Zeit gefunden, mich mit der Optimierung meiner FHEM Konfiguration zu beschäftigen. Ich hoffe, dass ich nun auch die zahlreichen Kommentare bei meinen übrigen FHEM-Beiträgen beantworten bzw. entsprechende Lösungen hier in weiteren Artikeln zeitnah präsentieren kann.

Eines der größten Ärgernisse meiner aktuellen SmartHome-Lösung war der Umstand, dass die Google Maps Auswertung bezüglich der Fahrzeiten – insbesondere unter Einbeziehung der aktuellen Verkehrslage – schon lange nicht mehr funktionierte. Irgendwann hat Google den Aufbau der Webseite geändert, so dass ich keine sinnvolle Lösung mehr gefunden habe, die Infos mittels regulärer Ausdrücke zu extrahieren. Auch in dem entsprechenden FHEM Forums-Beitrag hatte keiner eine passende Lösung.

Nun habe ich mich entschieden, dass Problem mit der verfügbaren Google Maps API zu lösen, wodurch ich nun unabhängig von Änderungen auf der entsprechenden Webseite bin. Nachfolgend werde ich Schritt für Schritt beschreiben, wie man die entsprechende API kostenfrei nutzen kann und wie ich die Informationen in meine FTUI-Lösung von FHEM eingebunden habe.

API Key von Google beziehen

Voraussetzung für die Nutzung der Google Maps Funktion in Verbindung mit den aktuellen Verkehrsinformationen ist ein sogenannter API-Key. Diesen Schlüssel kann man sich in Google Developer Console, die in erster Linie für Entwickler gedacht ist, die die Google Produkte zum Beispiel in ihren eigenen Apps nutzen wollen.

Bei der Nutzung der Google API hat man in der Regel die Möglichkeit, eine begrenzte Anzahl von Aufrufen kostenfrei zu nutzen. Dieses Kontingent sollte für die Nutzung in einer privaten Smarthome-Umgebung völlig ausreichend sein. Damit nun auch die etwas weniger erfahrenen FHEM-User an einen solchen API-Key gelangen gibt es nun eine ausführliche und bebilderte Schritt für Schritt Anleitung. Dadurch wird der Artikel zwar extrem lang, hilft aber hoffentlich allen Lesern.

1. Aufruf der Developer Console
   Für den Aufruf der Developer Console benötigt man natürlich einen Google Account, den man sich zuvor erstellen muß, sofern man nicht bereits Nutzer von Gmail ist. Zur Console gelangt man dann über diesen Link.
   

   Startseite Google Developer Console

2. Aufruf der Funktion „Google API verwenden“
3. Google Maps Distance API aufrufen
   In der Übersicht der APIs wählen wir nun die „Google Maps Distance API“ aus.
   

   Google API Übersicht

4. API aktivieren
   Nun muß die API noch aktiviert werden und man kann sich über den Reiter „Kontingente“ seine kostenlosen Kontingente (Aufrufe) für die API ansehen. Hierbei wird man auch noch aufgefordert, ein Projekt anzulegen.
   
5. „Zugangsdaten“ links im Menü auswählen
   Im Bereich der Zugangsdaten klickt man auf „Anmeldedaten“ sowie auf „Anmeldedaten hinzufügen“. Hier wird dann ein Dialog angezeigt, wo man den benötigten Key auswählen kann. Wir brauchen einen Browser Key und wählen diesen aus.
   
   

   Schlüssel auswählen

    

   

   Generierte API Schlüssel

Damit haben wir nun unseren benötigten API-Key und können diesen zum Beispiel direkt für die weitere Verwendung in FHEM kopieren.

Google Maps API mittels HTTPMOD Modul in FHEM integrieren

Zur Nutzung von Fahrzeiten innerhalb FHEM eignet sich das Modul HTTPMOD. Damit kann ein Aufruf einer Webseiten-URL integriert werden und mittels regulärer Ausdrücke ausgewertet werden. Auf die konkrete Beschreibung des Moduls gehe ich an dieser Stelle nicht ein.

HTTPMOD Definition

Die Definition für den Aufruf der von uns benötigten Google Maps Funktion sieht demnach wie folgt aus:

define FahrzeitKoelnBonn HTTPMOD https://maps.googleapis.com/maps/api/distancematrix/json?origins=KOELN,STRASSE+NR&destinations=BONN,STRASSE+NR&mode=driving&language=de-DE&departure_time=now&key=EIGENER_API_KEY 3600

Die Beschreibung zur API und der möglichen Parameter, die man nutzen kann, findet man hier bei Google. Wichtig ist, dass man neben dem API Key den Parameter „departure_time“ verwendet. Nur dann wird auch die Fahrzeit in Verbindung mit der aktuellen Verkehrslage ausgegeben. Bei der Verwendung der Funktion habe ich mich für die Ausgabe als json-Format entschieden. Es besteht auch die Möglichkeit einer xml-Ausgabe. Mit dem Wert 3600 am Ende wird die Fahrzeit im Abstand von einer Stunde aktualisiert.

Die Ausführung der Google Maps Funktion sollte in etwa folgendes Ergebnis zurück geben, welches dann anschließend innerhalb FHEM ausgewertet werden kann:

{
   "destination_addresses" : [ "Bonn, Deutschland" ],
   "origin_addresses" : [ "Köln, Deutschland" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "28,9 km",
                  "value" : 28887
               },
               "duration" : {
                  "text" : "36 Minuten",
                  "value" : 2130
               },
               "duration_in_traffic" : {
                  "text" : "35 Minuten",
                  "value" : 2075
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "status" : "OK"
}

Auswertung der API Rückgabe

Für die Anzeige der Informationen zum Beispiel in einer FTUI Oberfläche legen wir nun noch entsprechende Readings in unserer HTTPMOD Definition an. Ich verwende zwei Readings – eines für die normale Zeit und eines für die „Verkehrs-Zeit“. Die Definitionen inklusive der regulären Ausdrücke zur Ermittlung der konkreten Zeiten sieht wie folgt aus:

attr FahrzeitKoelnBonn reading01Expr GoogleExpr($val)
attr FahrzeitKoelnBonn reading01Name Standard
attr FahrzeitKoelnBonn reading01Regex (?s)duration.* "(.* Minuten).*duration_in
attr FahrzeitKoelnBonn reading02Expr GoogleExpr($val)
attr FahrzeitKoelnBonn reading02Name Verkehr
attr FahrzeitKoelnBonn reading02Regex (?s)duration_in.*"(.* Minuten)
attr FahrzeitKoelnBonn stateFormat Normal:Standard Aktuell:Verkehr

Da die Ausgabe der Fahrzeiten von Google ein wenig ungünstig ist, wenn man nur die reine Angabe in Form von „hh:mm“ benötigt, habe ich noch eine kleine Funktion zur Formatierung der Zeiten geschrieben. Die Ausgabe von Google ist zum Beispiel „30 Minuten“ oder „1 Stunde 25 Minuten“. Der Aufruf der Funktion geschieht über die Readings-Definition „reading01Expr“ im obigen Beispiel. Die Funktion dazu sieht wie folgt aus:

sub GoogleExpr($) 
{ my ($traffic) = @_; 

   #zunächst die Minuten ermitteln 
   $traffic =~ /([\d]+) Minuten?/;
   my $Std_Min = $1;
   my $Std_Std = "0"; 

   #falls Stunden angegeben sind, diese nun ermitteln
   if($traffic =~ /([\d]+) Stunden?/) { $Std_Std = $1; }
   return sprintf("%02d:%02d",$Std_Std,$Std_Min);
} 

In der obigen Definition der Attribute ist auch noch eine „StateFormat“ zu finden. Damit kann man die konkrete Ausgabe für die genutzten Readings nochmals festlegen.

Darstellung der Fahrzeiten mittels FTUI Oberfläche

Die Darstellung der Fahrzeiten mittels der von mir genutzten FTUI Oberfläche konnte man in den Screenshots aus meinen letzten FHEM-Beiträgen schon sehen. Hier nun nochmals der entsprechende Auszug aus der index.html.

<li EIGENE DEFINTION>
<header>
<div data-type="label" class="large">Fahrzeiten</div>
</header>
<table class="calls" width="100%">
<tr class="darker">
<th>Ziel</th>
<th>Normal</th>
<th>Aktuell</th>
</tr>
<tr>
<td>
<div data-type="label" class="cell">Bonn:</div>
</td>
<td>
<div data-type="label" data-device="FahrzeitKoelBonn" data-part="Normal:(.*).*Aktuell.*"></div>
</td>
<td>
<div data-type="label" data-device="FahrzeitKoelnBonn" data-part=".*Aktuell:(.*).*"></div>
</td>
</tr>
<tr>WEITERE FAHRZEITEN</tr>
</table>
</li>