Yr.no

API for badetemperaturer

Dersom du ønsker å sende inn badetemperaturer til oss, kan du lese hvordan på siden for API for mottak av badetemperaturer.

Vi har dessverre ikke lov til å videreformidle badetemperaturer fra enkelte av våre leverandører, slik at alle badetemperaturene du finner på Yr, ikke nødvendigvis gjenspeiles i API-et.

Vilkår

Tjenesten har god kapasitet og kan håndtere relativt store mengder forespørsler, men kapasiteten er ikke ubegrenset. Vi ber alle brukere respektere retningslinjene slik at tjenesten blir stabil. Det er ingen garantier for levering fra denne tjenesten, eller muligheter for å få en SLA.

API-et er laget for bruk på våre platformer, det vil si på nettsidene og i appene, men på grunn av stor etterspørsel har vi valgt å legge tilrette for ekstern bruk. Endringer på API-et kan komme uten forvarsel. Vi vil selvfølgelig prøve å unngå å gjøre endringer som påvirker eksterne brukere av API-et.

De viktigste reglene:

  • Du må identifisere deg (gjøres med API-nøkkel).
  • Du må ikke forårsake unødvendig trafikk.
  • Du må ikke overbelaste serverne våre.
  • Alt innhold du henter fra oss skal merkes med "Badetemperaturer levert av Yr"
  • Merkingen skal være godt synlig for publikum og stå i tilknytning til visningen av badetemperaturer.
  • Du har ikke lov til å lage tjenester som fremstår som om de er laget av Yr. Du kan med andre ord ikke bruke Yr som en del av navnet på tjenesten eller Yr logoen som en del av din tjeneste.
  • Du har ikke lov til å bruke innholdet vårt på nettsider med pornografisk eller rasistisk innhold, eller på nettsider som bryter norsk lov.
  • Du har ikke lov til å endre på innholdet (f.eks. plusse på et par grader på badetemperaturene).
  • Du har lov til å videredistribuere innholdet dersom du krediterer oss.
  • Du har lov til å bruke innholdet vårt sammen med vanlig reklame på ei nettside.
  • Du har lov til å bruke data fra Yr i kommersiell sammenheng, så lenge du følger alle nevnte  retningslinjer.

API-nøkkel

For å få API-nøkkel, send en epost til oss med "Forespørsel om API-nøkkel til badetemperaturer", med navn og epost til en kontaktperson, til support@yr.no. Spesifiser om du ønsker nøkkel for å hente ut eller sende inn badetemperaturer, eventuelt begge deler.

Beskrivelse av API-et

Merk: API-et leverer ikke temperaturer eldre enn fem døgn.

Base URL er https://badetemperaturer.yr.no

Requesten må inneholde en header, "apikey", med enn unik nøkkel som vi utsteder.

 

GET /api/watertemperatures

Henter alle de siste registrerte badetemperaturene.

Eksempel på respons:

[
   {
       "locationName": "Myrdammen",
       "locationId": "1-74090",
       "position": {
           "lat": 59.86241,
           "lon": 11.07866
       },
       "elevation": 195,
       "county": "Viken",
       "municipality": "Rælingen",
       "temperature": 19,
       "time": "2022-06-14T10:17:54+02:00"
   },
   {
       "locationName": "Nebbursvollen friluftsbad",
       "locationId": "1-2251575",
       "position": {
           "lat": 59.96759,
           "lon": 11.02616
       },
       "elevation": 105,
       "county": "Viken",
       "municipality": "Lillestrøm",
       "temperature": 25,
       "time": "2022-06-14T10:15:04+02:00",
       "heatedWater": true
   }
]

 

GET /api/regions/{regionId}/watertemperatures

Henter de siste registrerte badetemperaturene for en gitt region. 

"regionId": string  –> påkrevd – Oppgis på dette formatet NO-{fylkesnummer}-{kommunenummer}

Hente ut for Viken vil se sånn ut: /api/regions/NO-30/watertemperatures

Hente ut for Asker vil se sånn ut: /api/regions/NO-30-3025/watertemperatures

Fylke- og kommunenummer kan du finne her: Norske fylke og kommunar

Oslo må angis med ledende 0 i både fylke og kommune – NO-03-0301

 

GET /api/locations/{locationId}/watertemperatures

Henter ut de fem siste registreringene for et gitt sted med registrerte badetemperaturer.

"locationId": string –> påkrevd – Id-en for et sted som har badetemperaturer registrert på seg. Denne finner du i URL-en når du er inne på en stedsside på Yr.no. For eksempel har Sognsvann id-en 1-73595, https://www.yr.no/nb/v%C3%A6rvarsel/daglig-tabell/1-73595/Norge/Oslo/Oslo/Sognsvann
Spørringen vil da se sånn ut: /api/locations/1-73595/watertemperatures

Eksempel på respons:

[
    {
        "temperature": 16,
        "time": "2022-06-14T10:17:54+02:00"
    },
    {
        "temperature": 11,
        "time": "2021-10-19T06:17:54+02:00"
    },
    {
        "temperature": 19,
        "time": "2021-08-13T06:17:52+02:00"
    },
    {
        "temperature": 21,
        "time": "2021-07-13T06:17:51+02:00"
    },
    {
        "temperature": 17,
        "time": "2021-06-12T06:17:50+02:00"
    }
]

 

 

GET /api/locations/{locationId}/nearestwatertemperatures

Henter de seks nærmeste badetemperaturregistreringene innenfor en radius på 50 km.

"locationId": string –> påkrevd – Id-en for et sted. Denne finner du i URL-en når du er inne på en stedsside på Yr.no. For eksempel har Bodø id-en 1-269359, https://www.yr.no/nb/v%C3%A6rvarsel/daglig-tabell/1-269359/Norge/Nordland/Bod%C3%B8/Bod%C3%B8

Spørringen vil da se sånn ut: /api/locations/1-269359/nearestwatertemperatures

 

GET /api/locations/{latitude},{longitude}/nearestwatertemperatures

Henter de seks nærmeste badetemperaturregistreringene innenfor en radius på 50 km.

"latitude": double –> påkrevd – latitude på desimalgradfomat (se eksempel under)

"longitude": double –> påkrevd – longitude på desimalgradformat (se eksempel under)

Spørringen vil da se sånn ut: /api/locations/60.2758,5.4174/nearestwatertemperatures

Relaterte artikler