API Documentation

Beach data

Data can be retrieved by making a request to:
GET http://api.vandudsigten.dk/beaches
There are no mandatory or optional parameters.

The response format is JSON and an example of the response is shown below along with comments.
Textual information such as beach descriptions are only provided in Danish.

Water quality and weather types are detailed below.

[
  {
    id: 1,
    municipality: "København",
    municipality_url: "<a href='http://www.kk.dk/Borger/ByOgTrafik/GroenneOmraader/BadeVand.aspx'>badevandsside</a>",
    name: "Havnebadet Islandsbrygge",
    description: "Havnebadet Island Brygge ligger lige midt i byen som en del af havneparken på Islands Brygge...",
    latitude: 55.6689,
    longitude: 12.5789,
    comments: "",  // Comments describing the current situation
    facilities: "Varslingssystemet med konstant overvågning af vandkvalitet, livredder.",
    links: [  // Links to additional information
      "<a href='http://kubik.kk.dk/fisketorvetbad'>Havnebadet fisketorvet</a>",
      "<a href='http://www.aok.dk/byen-rundt/koebenhavns-havnebad-islands-brygge'>AOK Havnebadet Islands Brygge</a>",
      "<a href='http://www.kk.dk/Badevand'>Badevand</a>"
           ],
    
    data: [   // data is provided for today and the coming three days
              // All data is formatted as strings
              // Missing data will be formatted as an empty string, i.e. ""
            {
              date: "2012-04-30",       // "yyyy-mm-dd"
              water_quality: "4",       // water quality type either calculated by model
                                        // or overridden by expert 
                                        // possible values are {"1","2","3","4"}
              
              water_temperature: "9.2", // degrees C
              current_speed: "0.04",    // m/s
              current_direction: "49",  // degrees ("0"-"360")
              air_temperature: "9.0",   // degrees C
              wind_speed: "1.9",        // m/s
              wind_direction: "3",     // degrees ("0"-"360")
              weather_type: "2",        // Weather type, possible values are {"1"-"22"}
              precipitation: "0"        // mm/d
            },
            {
              date: "2012-05-01",
              water_quality: "4",
              water_temperature: "9.9",
              current_speed: "0.07",
              current_direction: "49",  // degrees ("0"-"360")
              air_temperature: "8.6",
              wind_speed: "",     // Missing data
              wind_direction: "", // Missing data
              weather_type: "",   // Missing data
              precipitation: ""   // Missing data
            },
            {
              date: "2012-05-02",
              water_quality: "4",
              water_temperature: "9.7",
              current_speed: "0.04",
              current_direction: "49",
              air_temperature: "9.0",
              wind_speed: "3.5",
              wind_direction: "3",
              weather_type: "2",
              precipitation: "0"
            },
            {
               date: "2012-05-03",
               water_quality: "4",
               water_temperature: "10.1",
               current_speed: "0.06",
               current_direction: "49",
               air_temperature: "9.4",
               wind_speed: "2.6",
               wind_direction: "3",
               weather_type: "1",
               precipitation: "0"
            }
           ]
  },
  {
    id: 2,
    municipality: "København",
	municipality_url: "<a href='http://www.kk.dk/Borger/ByOgTrafik/GroenneOmraader/BadeVand.aspx'>badevandsside</a>",
    name: "Havnebadet Fisketorvet",
    description: "Havnebadet ved Fisketorvet, 'Copencabana', ligger mellem Fisketorvet, Havneholmen og Kalvebod Brygge.",
    latitude: 55.663,
    longitude: 12.5652,
    comments: "",  // No comments
    facilities: "", // No information
    links: [], // No links
    data: [
            {
               date: "2012-04-30",
               water_quality: "4",
               water_temperature: "10.2",
               current_speed: "0.01",
               current_direction: "49",
               air_temperature: "9.0",
               wind_speed: "1.9",
               wind_direction: "3",
               weather_type: "2",
               precipitation: "0"
            },
          ]
  }
]

Water quality types

Water quality type	Icon	Description (Danish)
1		Dårlig badevandskvalitet
2		God badevandskvalitet
3		Ingen automatisk varsling
4		Badested lukket for sæsonen

Weather types

Weather Type	Icon	Description (Danish)
1		Sol
2		Letskyet
3		Halvskyet
4		Skyet
5		Enkelte regnbyger, perioder med sol
6		Enkelte tordenbyger, perioder med sol
7		Nogen regn eller slud, perioder med sol
8		Nogen sne, perioder med sol
9		Let regn
10		Regn
11		Torden og regn
12		Slud
13		Sne
14		Torden og sne
15		Tåge