Geosphere-Austria / dataset-api-docs

This is the documenation source for the dataset API provided by Geosphere Austria
https://dataset.api.hub.geosphere.at/v1/docs
9 stars 1 forks source link

Missing documentation: Weather symbols #30

Open kosmoz opened 3 months ago

kosmoz commented 3 months ago

Hi,

I was not able to find official documentation on the weather symbols returned by the API for the sy parameter. Do they correspond to the ones described here (mapped by the number in the file name of each picture)?

dlang-geosphereat commented 3 months ago

Hi @kosmoz ,

thank you for the feedback. The descriptions of the symbols are part of the dataset's metadata, however, our current interface is common across all datasets, which makes it difficult to provide parameter-specific metadata that exceeds information such as units/descriptions. We are currently working on a way to better provide this information.

As for the mapping, there are these (German only) descriptions for the codes: Icon ID Description
1 Wolkenlos
2 Heiter
3 Wolkig
4 Stark bewölkt
5 Bedeckt
6 Bodennebel
7 Hochnebel
8 Leichter Regen
9 Mäßiger Regen
10 Starker Regen
11 Schneeregen
12 Schneeregen
13 Schneeregen
14 Leichter Schneefall
15 Mäßiger Schneefall
16 Starker Schneefall
17 Regenschauer
18 Regenschauer
19 Starker Regenschauer
20 Schneeregenschauer
21 Schneeregenschauer
22 Schneeregenschauer
23 Schneeschauer
24 Schneeschauer
25 Starker Schneeschauer
26 Gewitter
27 Gewitter
28 Starkes Gewitter
29 Gewitter mit Schneeregen
30 Starkes Gewitter mit Schneeregen
31 Gewitter mit Schneefall
32 Starkes Gewitter mit Schneefall

As far as I know, we do currently not have official English translations (it should be fairly trivial to do this with Google Translate or similar, even if you don't know German). Also, I am aware that some descriptions such as "Gewitter" have two existing codes (26 and 27). I'll try to clarify this with data producers.

For the icons themselves, we currently do not provide an official icon set. We might provide some in the future, but I do not have information on this. Probably you will want to use icons that fit the design of your app anyway.