OpenWeatherMap

OpenWeatherMap-rajapinnan kautta kommunikoidaan Internetin välityksellä säädatojen hakuun. Käytetään sekä nykyisiä tietoja että ennustusta joka kolmas tunti viiden päivän ajan. Sääpalvelu on ilmainen.

Konfigurointi

Portissa tallennetaan paikka ja API-avain. Jokaisella rajapinnalla voidaan siis käyttää vain yhtä paikkaa. API-avaimen voi hankkia sivustolta openweathermap.org. Tämän pitäisi olla erillinen jokaiselle asiakkaalle, koska API-avain on nähtävissä milloin tahansa.

Säädatojen kieli voidaan konfiguroida Lisäasetukset-välilehdellä.

Muuttujat

Muuttuja time, palauttaa aina viimeisen kyselyn ajan. Tämä muuttuja ei tallenneta Monitoriin.

Sijainti

Muuttuja	Kuvaus
city [string]	Kaupungin nimi.
country [string]	Maan lyhenne. Esimerkiksi CH.
timezone [time]	Aikavyöhykkeen offset millisekunneissa.
sunrise [datetime]	Tänään auringonnousu.
sunset [datetime]	Tänään auringonlasku.
geolat [real]	Leveysaste.
geolng [real]	Pituusaste.

Huomautus: Auringonnousu ja lasku lasketaan vain haettujen tietojen jälkeen. Suositellaan käyttämään sen sijaan Toimintosarja SUNINFO.

Nykyinen Sää Ja Ennustus

Joka kolmen tunnin välein haetaan samat arvot. Nämä ovat erilaisia etuliitteillä. Etuliite act_ palauttaa nykyiset arvot.

Muuttuja	Kuvaus
dt [datetime]	Absoluuttinen aika, jolle kerätyt tiedot ovat voimassa.
id [int]	Sään tila-Id OpenWeatherMapin mukaan.
icon [string]	Sääkuva.
main [string]	Sään kuvaus englanniksi.
description [string]	Tarkempi sään kuvaus englanniksi.
temp [real]	Lämpötila °C:ssä.
humidity [int]	Suhteellinen kosteus %.
visibility [int]	Näkyvyys metreinä.
rain [real]	Sademäärä mm:ssä.
snow [real]	Lumimäärä mm:ssä.
preassure [int]	Ilmanpaine merenpinnan tasolla mbar:ssa.
clouds [int]	Pilvisyys %.
windspeed [real]	Tuulen nopeus m/s:ssä.
winddirection [real]	Tuulen suunta °:ssä.

Vinkki: On olemassa sisäinen kuvakirjasto muuttujille id ja icon. Katso Sää-Ikonit.