Wetter APIs

Überblick und Vergleich

Um in einer App oder Webseite Wetterdaten verarbeiten zu können, stellt sich zunächst die Frage nach der Quelle der Daten. Dazu konkurrieren einige API-Anbieter miteinander, einige davon kostenlos. In diesem Artikel lege ich den Schwerpunkt auf die kostenlos verfügbaren APIs. 

Verglichen werden (bisher)...

OpenWeather

Yahoo Weather

Metwit Weather 

Wunderground

Wetter.com

Wetter-Api.de

Angeregt zu dieser Gegenüberstellung hatte mich mein Vorhaben, in meiner Foto-Filter-App Kleckrica 44 Filter anzubieten, die Informationen zum aktuellen Wetter in den Fotos anzeigen. Ergo stand ich vor genau diesem Problem. Was nehmen? Wie geht das? Was kostet das? Gibt's da auch etwas Kostenloses?

Open Weather

OpenWeatherMap.org war eigentlich die zweite Alternative nach Yahoo. Allerdings war es die erste, die ich vollständig implementiert hatte. Deshalb stelle ich es hier als erstes vor. 
Die API bietet die Resultate als XML oder JSON an (oder HTML). Als Input können Geo-Koordinaten oder ein Städtename verwendet werden. Die Aktualität liegt zwischen zehn Minuten und zwei Stunden für die kostenlose API. Die Daten stehen unter CC BY-SA 2.0, d.h. die Daten können kommerziell verwendet werden.

Inzwischen bietet OpenWeatherMap vier verschiedene Pricing-Modelle bzw. SLAs an. Das kostenlose Angebot "FREE" ist limitiert auf 1200 Abrufe/Minute und die Daten werden im Abstand von zwei Stunden aktualisiert. Höhere Aktualisierungsraten, SLAs und Kontingente sind kostenpflichtig. Allerdings sind die festen monatlichen Preise deutlich planbarer als die Kosten/1000 Requests, die bei Yahoo schnell unkontrollierbar steigen können. 

Angeobten wird das aktuelle Wetter, Vorhersagen für 5 Tage per 3 Stunden, 16 Tage täglich sowie historische Wetterdaten und Daten einzelner Stationen. Ausserdem werden diverse Wetterkarten angeboten. Insgesamt, finde ich, ist es das umfassenste Angebot der verglichenen Dienste. 

Die Wetterdaten können unmittelbar wahlweise per Geo-Koordinaten, Name einer Stadt oder PLZ abgerufen werden. Zur eindeutigen Identifizierung einer Stadt steht ebenfalls ein City-Code zur Verfügung, wie das bei vielen anderen Diensten (s.u.) auch der Fall ist. Die Abfrage kann für mehrere Orte gleichzeitig erfolgen, wobei diesbezüglich das Preismodell zu beachten ist. Dieser Service steht nicht kostenfrei zur Verfügung. 

Das Ergebnis steht wahlweise in XML oder JSON zur Verfügung. Die API ist mulilingual. Literale können in mehrern Sprachen angefordert und dann direkt verwendet werden. Als optionale Einheiten stehen Celsius und Farenheit zur Verfügung. Default ist Kevin. 

Ausserdem ist die API auf der Webseite ausgesprochen gut dokumentiert. (Englisch) 

Beispielsweise führt die Abfrage mit Geo-Koordinaten von Achill Island 

http://api.openweathermap.org/data/2.5/weather?lat=53.9667&lon=-10&appid=MyAPIKey

(Testweise kann der API-Key scheinbar auch weggelassen werden.  http://api.openweathermap.org/data/2.5/weather?lat=53.9667&lon=-10 )

zu diesem beispielhaften Ergebnis in JSON. 

{
   "coord":{
      "lon":-9.72,
      "lat":53.9
   },
   "weather":[
      {
         "id":800,
         "main":"Clear",
         "description":"Sky is Clear",
         "icon":"01d"
      }
   ],
   "base":"stations",
   "main":{
      "temp":283.499,
      "pressure":1039.19,
      "humidity":96,
      "temp_min":283.499,
      "temp_max":283.499,
      "sea_level":1048.75,
      "grnd_level":1039.19
   },
   "wind":{
      "speed":1.66,
      "deg":97.508
   },
   "clouds":{
      "all":0
   },
   "dt":1443688483,
   "sys":{
      "message":0.0184,
      "country":"IE",
      "sunrise":1443681639,
      "sunset":1443723322
   },
   "id":2961666,
   "name":"Rosturk",
   "cod":200
} 

Weiterführende Links

Weather Conditions und Icons: http://openweathermap.org/weather-conditions

Angaben zu den Kosten: http://openweathermap.org/price

Yahoo Weather

Yahoo war eigentlich meine erste Wahl, als ich mich nach Wetter-APIs umschaute. Es gibt reichlich Tutorials und ist auch gar nicht so wahnsinnig schwierig. Die API wird als RSS in XML angeboten. Das Resultat kann auch in JSON angefordert werden. 

Der Knackpunkt bei Yahoo ist, dass man das Wetter nicht direkt zu Geo-Koordinaten abfragen kann. Man muß zunächst als regionale Referenz eine sog. WOEID anfordern und kann dann die Wetterdaten zu dieser WOEID anfordern. Allerdings wurde die kostenlose API zur Abfrage der WOEID zu Geokoordinaten (oder auch Ortsnamen) vor einiger Zeit eingestellt. Der Dienst wurde durch Yahoo Boss ersetzt. Boss ist allerdings kostenpflichtig bzw. bietet für nicht-gewerbliche Projekte eine kostenfreie Nutzung bis zu 2000 Requests pro Tag an. Wer also auf etwas Erfolg mit seiner App hofft, auch wenn sie keinen gewerblichen Hintergrund hat, riskiert, seine Kreditkarte nicht unerheblich belasten zu müssen.
(Leider enthält Yahoos Webseite keine Angaben zur Zeitspanne, für welche das 2000er Limit gelten soll. Die meisten Quellen sprechen von 2000/Tag in Bezug auf die Places-Tabelle und 2000/Stunde in Bezug auf die Anzahl Request per IP für den Endpunkt.)

Damit keine Mißverständnisse auftreten: Die Yahoos Wetter-API steht weiterhin kostenlos zur Verfügung, allerdings setzt sie die WOEID voraus. Und die Suche nach der WOEID ausgehend von Geo-Daten ist kostenpflichtig. Um Wetterdaten für einen bestimmten Ort anzuzeigen, wäre die API immer noch eine gute alternative. Auch für Vohersagen bei denen der Anwender einen Ortsnahmen als Suchbegriff eingibt, ist die API sicher gut einsetzbar. Deshalb möchte ich dennoch das Vorgehen kurz erläutern. 

Umweg über yahoo search

Um der kostenpflichtigen bzw. begrenzten BOSS API aus dem Weg zu gehen, bietet sich für Mobile Apps der Umweg über das integrierte Geo-Coding an. Die SDK für iOS, Android und Windows Phone bieten native Reverse-Geo-Coding APIs, deren Verwendung kostenfrei und unlimitiert ist. (Für Google/Android könnte es Begrenzungen geben, falls die App zu einem kostenpflichtigen Dienst gehört, nicht aber falls die App etwas Geld kostet.) Ermittelt man auf diesem Weg den Ort zu einer Geo-Location, dann kann man den Ort über die Search-API suchen und bekommt im Ergebnis u.a. die woeid zurück. 

Dazu ein Code-Beispiel für iOS/Objective-C bzw. Cocoa Touch

CLGeocoder *geocoder = [[CLGeocoder alloc] init]; 
[geocoder reverseGeocodeLocation:location 
	               completionHandler:^(NSArray *placemarks, NSError *error) {
		           if (error){
			   NSLog(@"Geocode failed with error: %@", error);
			   return;
			}                    
			CLPlacemark *placemark = [placemarks objectAtIndex:0];
			NSLog(@"cityname - %@",placemark.locality);
}]; 

für Dortmund:  

{  
   "q":"Dortmund",
   "l":{  
      "gprid":"klD_92z1SOahI3R9Y.7fAA"
   },
   "r":[  
      {  
         "k":"Dortmund",
         "d":"pt:iso=DE&woeid=645458&lon=7.45829&lat=51.5166&s=North Rhine-Westphalia&c=Germany&country_woeid=23424829&n=Dortmund, North Rhine-Westphalia, Germany"
      }
   ]
} 

Mit der WOEID für Dortmund 645458 ließe sich dann das Wetter erfragen.

Die URI http://weather.yahooapis.com/forecastrss?w=23424829&u=c füht zu folgendem beispielhaften Ergebnis: 

Dabei ist 23424829 die woied für Dortmund (siehe obige response) und c gibt an, dass das Ergebnis in Celsius ausgegeben werden soll. Default ist Fahrenheit, wenn man &u= nicht mit angibt. 

{
   "query":{
      "count":1,
      "created":"2015-09-24T17:28:31Z",
      "lang":"de",
      "results":{
         "channel":{
            "title":"Yahoo! Weather - Dortmund, DE",
            "link":"http://us.rd.yahoo.com/dailynews/rss/weather/Dortmund__DE/*http://weather.yahoo.com/forecast/GMXX0024_f.html",
            "description":"Yahoo! Weather for Dortmund, DE",
            "language":"en-us",
            "lastBuildDate":"Thu, 24 Sep 2015 6:49 pm CEST",
            "ttl":"60",
            "location":{
               "city":"Dortmund",
               "country":"Germany",
               "region":"NW"
            },
            "units":{
               "distance":"mi",
               "pressure":"in",
               "speed":"mph",
               "temperature":"F"
            },
            "wind":{
               "chill":"61",
               "direction":"210",
               "speed":"8"
            },
            "atmosphere":{
               "humidity":"63",
               "pressure":"30.03",
               "rising":"0",
               "visibility":"6.21"
            },
            "astronomy":{
               "sunrise":"7:18 am",
               "sunset":"7:23 pm"
            },
            "image":{
               "title":"Yahoo! Weather",
               "width":"142",
               "height":"18",
               "link":"http://weather.yahoo.com",
               "url":"http://l.yimg.com/a/i/brand/purplelogo//uh/us/news-wea.gif"
            },
            "item":{
               "title":"Conditions for Dortmund, DE at 6:49 pm CEST",
               "lat":"51.52",
               "long":"7.46",
               "link":"http://us.rd.yahoo.com/dailynews/rss/weather/Dortmund__DE/*http://weather.yahoo.com/forecast/GMXX0024_f.html",
               "pubDate":"Thu, 24 Sep 2015 6:49 pm CEST",
               "condition":{
                  "code":"28",
                  "date":"Thu, 24 Sep 2015 6:49 pm CEST",
                  "temp":"61",
                  "text":"Mostly Cloudy"
               },
               "description":"\n<img src=\"http://l.yimg.com/a/i/us/we/52/28.gif\"/><br />\n<b>Current Conditions:</b><br />\nMostly Cloudy, 61 F<BR />\n<BR /><b>Forecast:</b><BR />\nThu - Cloudy. High: 62 Low: 51<br />\nFri - Partly Cloudy. High: 62 Low: 44<br />\nSat - Partly Cloudy. High: 61 Low: 43<br />\nSun - Sunny. High: 61 Low: 43<br />\nMon - Sunny. High: 62 Low: 43<br />\n<br />\n<a href=\"http://us.rd.yahoo.com/dailynews/rss/weather/Dortmund__DE/*http://weather.yahoo.com/forecast/GMXX0024_f.html\">Full Forecast at Yahoo! Weather</a><BR/><BR/>\n(provided by <a href=\"http://www.weather.com\" >The Weather Channel</a>)<br/>\n",
               "forecast":[
                  {
                     "code":"26",
                     "date":"24 Sep 2015",
                     "day":"Thu",
                     "high":"62",
                     "low":"51",
                     "text":"Cloudy"
                  },
                  {
                     "code":"32",
                     "date":"28 Sep 2015",
                     "day":"Mon",
                     "high":"62",
                     "low":"43",
                     "text":"Sunny"
                  }
               ],
               "guid":{
                  "isPermaLink":"false",
                  "content":"GMXX0024_2015_09_28_7_00_CEST"
               }
            }
         }
      }
   }
} 

(Die Antwort enthält fünf Vorhersage-Elemente im entsprechenden JSON-Array. Die Antwort wurde zugunten der Lesbarkeit des Artikels dort gekürzt.  

Weiterführende Links

https://developer.yahoo.com/boss/geo/

https://developer.yahoo.com/yql/guide/usage_info_limits.html (Limits for Endpoints; Additional Limitations to the Table apply) 

https://developer.yahoo.com/weather/documentation.html (Doku inkl. weather condition codes) 

Metwit Weather

Auf Metwit wurde ich aufmerksam, als ich nach Alternativen suchte für Yahoo's nicht mehr kostenfrei verfügbaren Yahoo Placefinder API. 

Nun, ihre Hompepage http://www.metwit.com scheint aktuell (3.10.2015) nicht richtig funktionieren zu wollen.

Weiterführende Links

http://www.metwit.com

http://soup.metwit.com/post/47181933854/an-alternative-to-yahoo-weather-api  

Wunderground (weather.com)

Kostenlos ist die Verwendung scheinbar ausschließlich für Entwickler mit für die Produktion unbrauchbaren Limitierungen. 

http://www.wunderground.com/weather/api?apiref=3be21450e864dc6e

Weiterführende Links

http://www.chrisge.org/blog/2013-03-09/wundergound_api

Wetter.com

Bei Wetter.com gliedert sich die Suche wieder in zwei Bereiche. Zunächst steht die Suche nach einem City-Code zu einem Ort. Leider gibt es wohl keine Möglichkeit, nach Geo-Koordinaten zu suchen. Den aktuellen Standort zu finden dürfte sich genauso fehleranfällig gestalten wie bei Yahoo.com. 

Die API kann grundsätzlich kostenlos verwendet werden. Dazu müssen zwei der drei Verweise auf Wetter.com implementiert werden:
1."Powered by wetter.com"
2. Link zu wetter.com
3. Wetter.com Logo wird angezeigt. 

API Key erhalten

Nach der Registrierung bei wetter.com legt man ein Projekt an und erhält für dieses Projekt einen API-Key. 

Ortsname ermitteln

Um vom den Geo-Koordnaten des aktuellen Standorts auf den Ortsnamen kommen, kann zunächst analog wie beim Workaround für YahooWeather vorgegangen werden. D.h. man kann das im mobilen OS nativ angebotene Reverse-Geocoding verwenden. 

City-Code ermitteln

Mit dem Ortsnamen läßt sich nun die URL ermitteln um zum Ort u.a. den City-Code zu erhalten. In das URL-Schema (s. Dokumentation) fließen der Ortsname, der Projektname und ein aus Projektname, API-Key und Ortsname bzw. Suchbegriff (in dieser Reihenfolge ohne Trennzeichen) ermittelten MD5-Hash ein. Am Beispiel Mettmann ergibt sich daraus aus dieser Anfrage

http://api.wetter.com/location/index/search/Mettmann/project/my-very-own-project/cs/0413c766560897be194720cb02d43f2b

folgende Antwort

<?xml version="1.0" encoding="UTF-8"?>
<search>
    <search_string>
        <![CDATA[Mettmann]]>
    </search_string>
    <maxhits>30</maxhits>
    <hits>1</hits>
    <exact_match>no</exact_match>
    <credit>
        <!--In order to use the free weather data from wetter.com you HAVE TO display at least two out of three of the following possibilities: text, link, logo-->
        <text>Powered by wetter.com</text>
        <link>http://www.wetter.com</link>
        <logo>Download at http://www.wetter.com/api/downloads/#logos</logo>
    </credit>
    <result>
        <item value="1">
            <city_code>DE0006935</city_code>
            <plz>40822</plz>
            <name>Mettmann</name>
            <quarter />
            <adm_1_code>DE</adm_1_code>
            <adm_2_name>Nordrhein-Westfalen</adm_2_name>
            <adm_4_name>Mettmann</adm_4_name>
        </item>
    </result>
</search> 

Falls mehr als ein Ergebnis zurück gegeben wurde, bietet es sich an, weiteren Daten zu jedem Ort wie PLZ oder andere administrative Einheiten mit den Daten abzugleichen, die das Reverse-Geocoding ergeben hat, um eine möglichst den richtigen Ort zu erhalten. (Je nach Usecase könnte auch der Anwender dazu befragt werden, was in meinem Fall kein gutes Benutzererlebnis zur Folge hätte.) 

Wetter abfragen

Nun können wir daraus den City-Code extrahieren und mit diesem endlich die Wetter-Anfrage bauen. Der Request

http://api.wetter.com/forecast/weather/city/DE0006935/project/my-very-own-project/cs/4098a47c35b72fb4fdbd5c898e9fa596

ergibt die Antwort:

Weiterführende Links

http://www.wetter.com/apps_und_mehr/website/api/dokumentation/

http://api.wetter.com/files/wetter.com_openweather_api.pdf

Logos (Enthält auch Icons)

Wetter-Api.de

Kostenlos bis 250 Zugriffe pro Tag. 

Stellt Wetterdaten nur für Deutschland bereit.
Liefert die Daten ausschließlich in XML aus. 

Anekdote am Rande: Direkt nach der ersten Anmeldung nach Registrierung wird angezeigt, man habe das maximale Limit für den laufenden Tag bereits erreicht. :-) 

Die Abfrage geschieht über die Postleitzahl des Ortes. Gut ist daran, dass die PLZ über die Reverse-Geocoding APIs in Android und iOS recht gut und zuverlässig ermittelt werden können. 

So führt die Abfrage http://www.wetter-api.de/wetter-MyKey-85737.xml (wobei MyKey durch den jeweiligen API-Key ersetzt werden muss) zu der Antwort: 

<?xml version="1.0" encoding="UTF-8"?>
<vorhersage>
   <ort>Ismaning</ort>
   <aktuell>
      <icon>partlycloudy</icon>
      <icon_url>http:www.wetter-api.de/wettericon/partlycloudy.gif</icon_url>
      <temperatur>12</temperatur>
      <feuchtigkeit>54</feuchtigkeit>
      <wind>33</wind>
      <windrichtung>East</windrichtung>
      <druck>1030</druck>
      <regen>-99990</regen>
      <schnee>0</schnee>
      <sicht>3</sicht>
   </aktuell>
   <vorhersagetage>
      <vorhersagetag>
         <datum>
            <epoche>1443718800</epoche>
            <tag>1</tag>
            <monat>10</monat>
            <jahr>2015</jahr>
            <tagdesjahres>273</tagdesjahres>
            <stunde>19</stunde>
            <min>00</min>
            <sec>0</sec>
         </datum>
         <periode>1</periode>
         <hoch>
            <celsius>17</celsius>
         </hoch>
         <tief>
            <celsius>3</celsius>
         </tief>
         <conditions>Heiter</conditions>
         <icon>clear</icon>
         <icon_url>http:www.wetter-api.de/wettericon/clear.gif</icon_url>
         <regenwahrscheinlichkeit>0</regenwahrscheinlichkeit>
         <regen>
            <mm>0</mm>
         </regen>
         <schnee>
            <cm>0</cm>
         </schnee>
         <wind>
            <kmh>1</kmh>
            <dir>O</dir>
         </wind>
         <feuchtigkeit>5</feuchtigkeit>
      </vorhersagetag>
<!--- Hier wurden weitere Vorhersagetage ausgeblendet -->
   </vorhersagetage>
   <warnung>
      <warnungvor />
      <warnstufe />
      <![CDATA[<warninfo></warninfo>]]>
   </warnung>
</vorhersage> 

(Die Antwort enthält 9 Vorhersagetage, von denen 8 zur besseren Lesbarkeit des Artikels ausgeblendet wurden.)

Weiterführende Links

http://www.wetter-api.de

Fonts und Icon-Sammlungen

Zu guter letzt muss das Wetter noch dargestellt werden. Dazu habe ich ein paar Icon-Sammlungen und Fonts entdeckt.