Momentan vinddata kan utläsas i ett format mer lämpligt för tolkning av ett datorprogram. Detta möjliggör att andra applikationer än denna sajt kan dra nytta av insamlad vinddata.
Datan finns tillgängligt i både JSON-kodat format och XML-kodat format. Alla aktiva vindmätare listas i en index-fil, som definierar varje mätares unika ID samt all statisk information.
Givet en vindmätares unika ID (från index-fil) kan ett par dygns historik hämtas via adress-schemat:
Där <id> skall ersättas med önskad stations ID, som listas i index-filen. T.ex. kan man hämta historik från mätaren 'Svetlana' genom adressen http://vind.minimum.se/api/v3/Svetlana/history.json
Notera att historiken är sorterad efter mätpunkternas datum i fallande ordning, dvs den mest aktuella mätpunkten sorteras högst upp i historik-filen.
För applikationer som önskar att läsa ut endast den senaste mätpunkten (av t.ex. bandbreddsskäl) finns denna i filen latest.json, som i övrigt har exakt samma format som historik-filen.
För tillfället finns inga restriktioner på hur ofta JSON-filerna kan hämtas. Använd sunt förnuft! Filen uppdateras enligt vindmätarens inställningar (vilket kan utläsas i index-filens "pollrate"-fält för varje station). Det är därför meningslöst att hämta uppdateringar med en högre frekvens än detta intervall. Då och då kan uppdateringar utgå, detta kan bero på att vindmätaren är tillfälligt ur funktion eller att GSM-nätet trollat bort paket på vägen. Det är vanligt att vindmätaren bara är igång dagstid på vintern då solen inte räcker till för att ladda upp batteriet tillräckligt för att klara natten.
Klicka här för att visa exempelkod i PHP (krav v4.3.0 eller senare). Exemplet visar hur JSON-indexfilen kan laddas ner, tolkas samt hur data kan hämtas från varje listad station. Klicka här för att provköra exemplet live.
Nedan visas ett exempel på den JSON-data som representerar en mätpunkt hos en vindmätare. För detaljerad fältinformation, se innehållsförteckning nedan.
JSON strukturerar data i fält av olika typer. Nedan är en förteckning över de fält som används.
Följande fält ingår i index-filen, en uppsättning per vindmätare.
| Fält | Typ | Kommentar |
|---|---|---|
| id | Sträng | Stationsnamn (unik identifierare). |
| pollrate | Heltal | Uppdateringsinterval i sekunder, dvs hur ofta vindmätaren sänder ny vinddata. Kan användas för att avgöra hur ofta uppdatering bör ske. |
| lastupdate | Heltal | Senaste uppdateringen, UNIX timestamp-format (antal sekunder sen 1970) |
| pos_lon | Flyttal | Geografisk position ("GPS koordinat"), longitud-komponent. |
| pos_lat | Flyttal | Geografik position ("GPS koordinat"), latitud-komponent. |
| description | Sträng | Textbeskrivning av vindmätare. |
| friendlyname | Sträng | Fullständigt stationsnamn, detta bör användas vid presentation för användare. id (se ovan) bör endast användas för identifiering inom API. |
Både "latest.json" och "history.json" innehåller mätpunkter. Nedan är fältbeskrivning för EN mätpunkt.
| Fält | Typ | Kommentar |
|---|---|---|
| airtemp_avg | Flyttal | Genomsnittlig lufttemperatur under mätperiod (grader celcius). Kan anta värdet "null" om ej tillgängligt. |
| humidity | Heltal | Relativ luftfuktighet under mätperiod (%). Kan anta värdet "null" om ej tillgängligt. |
| windspeed_max | Flyttal | Högsta vindhastighet (byvind) uppmätt under perioden (m/s). |
| num_samples | Heltal | Antal mätningar under given mätperiod. |
| air_pressure | Heltal | Lufttryck, i hPa (millibar). Kan anat värdet "null" om ej tillgängligt. |
| first_sample | Heltal | Tidsstämpel för första mätning i given mätperiod (UNIX timestamp-format). |
| stationid | Sträng | Stations ID. |
| winddir_stability | Flyttal | Stabilitet vindriktning (0-15). (Standardavvikelse under mätperiod). |
| windspeed_min | Flyttal | Lägsta vindhastighet uppmätt under perioden (m/s). |
| windspeed_avg | Flyttal | Genomsnittlig vindhastighet uppmätt under perioden (m/s). |
| winddir_avg | Heltal | Genomsnittlig vindriktning under mätperiod (grader). |
| last_sample | Heltal | Tidsstämpel för sista mätning i given mätperiod (UNIX timestamp-format). |
På denna sidan kommer jag att samla all information kring mitt vindmätarbygge. Tanken är att ta fram en "billig" (billigare) vindmätare som tillhandahåller ungefär samma funktionalitet som de dyrare italienska vindmätarmodellerna, som bl a står på Hammar idag (Svetlana).
Funktioner/Specifikation:
Utläsning av aktuella vindförhållanden:
Copyright Magnus Olsson © 2011-2012. Alla rättigheter förbehållna.