AWEKAS-serveruitlezing
Concept_00_20220912 + Update_20250427
XWeather-serveruitlezing
Concept_00_20250427
Meedoen met je AWEKAS-account of je XWeather-account als databron
Voor aankoppelen van de API naar de HWA-server lijken AWEKAS-API en XWeather-API heel erg op elkaar:
daarom een gemeenschappelijke beschrijving.
Wanneer je jouw weerstation
minimaal 2 maanden zelf getest hebt, kun je meedoen aan HetWeerActueel.
Belangrijke aspecten zijn stabiliteit en correctheid van de data: dat laatste kun je voorzichtig testen door vergelijking met naburige officiële weerstations en met naburige HWA-stations.
Als je
AWEKAS of
XWeather wil gebruiken als
databron voor je weergegevens naar HetWeerActueel zonder een script draaiend in je eigen configuratie dat de benodigde HWA-file maakt, dan kun je deze instructie volgen om mee te doen met opname op
www.hetweeractueel.nl.
Generatie van een HWA-file vanuit de API van AWEKAS/XWeather naar de HWA-server betekent dan dat het bestand benodigd voor HWA in realtime wordt gemaakt tijdens de URL-aanroep naar het betreffende AWEKAS/XWeather-account, direct vanuit de aangeroepen software van de HWA-server (samengevat het ‘uitlees-script’, zoals genoemd op de Homepage van de Handleiding).
1. Voorwaarde
Er is daarbij 1 voorwaarde:
Als stationsbeheerder van het betreffende AWEKAS/XWeather-station moet je daarvoor de inlog-gegevens ter beschikking stellen bij je stationsaanmelding:
• AWEKAS-stationsID resp. XWeather-stationsID,
zodat we bij AWEKAS of XWeather kunnen bekijken of/hoe je configuratie bij AWEKAS of XWeather goed werkt, en ook als handvat voor API-aanroep.
Dit is dus de stationsnaam waarmee je station wordt genoemd op het AWEKAS/XWeather-dashboard:
voor eenduidigheid ook handig om bij AWEKAS-aanmelding het stationsnummer te noemen!
• Voor AWEKAS-koppeling de AWEKAS-APIKey, die je vindt in de profile-webpagina van je AWEKAS-account.
Bijkomende technische voorwaarde is dat die AWEKAS_APIKey niet meer mag veranderen, want anders zal de uitlezing naar de HWA-server worden verstoord!
• Voor XWeather-koppeling
bij voorkeur met toepasselijke ClientID+ClientSecret.
XWeather-eigenaardigheid, maar voor API-aanroep heb je een ClientID+ClientSecret nodig, en daarvoor moet je eerst een bijbehorende Application oprichten in je gratis Developer-account, te verkrijgen als verdienste uit je Contributor-plan.
We zouden gebruik kunnen maken van de ClientID+ClientSecret van HWA's Developer-account,
maar met per Developer-account een toegestaan, gratis volume van max. 1000calls/dag zouden we dan vanuit HWA noodgedwongen de call-frequentie/station moeten verlagen afhankelijk van het aantal stations aangeroepen bij XWeather, of we moeten gaan betalen.
Bij ClientID+ClientSecret meegeleverd door de stationsaanmelder kunnen we voor zijn/haar station ongestoord per 5 of 10 minuten aanroepen.
Bijkomende technische voorwaarde is dan dat na aanmelding een Cliënt-infoset niet meer mag veranderen, want anders zal de XWeather-uitlezing naar de HWA-server worden verstoord!
2. Realisatie
Op zich geldt gewoon het normale aanmeldformulier, met de volgende invulling m.b.t. AWEKAS/XWeather voor de totstandkoming van de HWA-file en de uitlees-url.
Voor aanmelding bij HWA met de bedoeling gebruik te maken van de functie die je AWEKAS/XWeather-station direct uitleest, dan
• Volstaat aanmelding volgens het aangehangen formulier
Beheer & Moderatie van HetWeerActueel pakken die aanmelding op en zorgen voor de koppeling tussen je AWEKAS-account resp. XWeather-account, en de HWA-server.
De HWA-server en zijn achterland doen daarna de rest buitenom je lokale configuratie met uitlezen van je AWEKAS-account resp. je XWeather-account.
3. Aanmelding naar het beheer van HetWeerActueel.nl
Onderstaande gegevens in het formulier op geven.
Indien we niet de juiste gegevens hebben, kunnen we je station niet toevoegen!
• Je gebruikersnaam/accountnaam op het forum.
Registratie van een account voorafgaand aan deze aanmelding is verplicht, omdat je alleen met dit account je station kunt beheren.
• Het email-adres waarop wij je kunnen bereiken, zodat we regelrecht contact kunnen hebben (ook buiten het forum) over voorkomende zaken.
• Plaatsnaam én de provincie waar je weerstation staat.
Eventueel met aanduiding van een apart kenmerk zoals als een wijk of stadsdeel, als je weet dat er in die plaats al meer HWA-stations zijn.
• Exacte decimale GPS locatie (lat/lon) van het weerstation. Gebruik de notatie 51.22432 , 6.033428 (en
niet bijvoorbeeld 51° 3′ 23″ N, 6° 21 23″O).
• AWEKAS/XWeather_StationsID, is het label waaronder bij je AWEKAS/XWeather-station is te vinden.
Een AWEKAS-station heeft ook een numerieke identificatie: die identificatie is niet nodig voor API-aanroep, maar wel handig voor doublecheck dat we het goede station koppelen.
• Onder ‘Configuratie-informatie’ is de volgende info verplicht:
o voor AWEKAS welke AWEKAS_APIKey je gebruikt, zoals uitgelegd onder 1.
o voor XWeather welke XWeather_ClientID+ClientSecret van toepassing zijn, zoals uitgelegd onder 1.
o welk merk/type weerstation je gebruikt als databron
(voor AWEKAS als bevestiging/aanvulling op de info op je AWEKAS-vermelding, en
voor XWeather als noodzakelijke achtergrond-info voor HWA-setup)
• Eventueel optioneel ook andere informatie die je direct belangrijk vindt als ‘Aanvullend bericht’.
Na acceptatie van je stations-aanmelding, kun je zelf meer stations-informatie invoeren via de Beheermodule van de stationspagina.
Latere mutaties in bovenstaande aanmeldinformatie bij voorkeur via een
Privee
Bericht melden aan de
groep Algemene moderators.
Formulier
Vul dit formulier in lijn met de beschrijving.
Forum accountnaam (verplicht)
Je e-mailadres (verplicht)
Plaatsnaam (verplicht)
Provincie (verplicht)
GPS Lat/Lon (verplicht, decimaal)
AWEKAS/XWeather_StationsID (verplicht),
als vervanger van 'Link naar uploadbestand'
Configuratie-Informatie (verplicht),
incl. AWEKAS_APIkey resp. XWeather_ClientID&ClientSecret
incl. type weerstation (Merk&Model)
Aanvullend bericht (optioneel)
