For utviklere

Tårn-API-et. Åpent, gratis, uten nøkkel.

Hele registeret over Oslos tårn, 374 bygg, kan hentes som JSON. Ingen konto, ingen nøkkel, ingen søknad. Lag et kart, en app, en quiz eller noe vi ikke har tenkt på. Vi blir glade av å se det.

curl https://taarnforeningen.no/api/v1/tilfeldig

Endepunktene

Alt svarer med JSON, alt kan hentes fra andre nettsider (CORS er åpent), og alt er bare lesing.

AdresseHva du får
/api/v1Oversikten: antall tårn, endepunktene og lisensen.
/api/v1/taarnAlle tårn. Filtrer med bydel, kategori, arkitekt, stil, type, tiaar (for eksempel 1890), faktor_min (1–10) og sok. Bla med limit (høyst 500) og offset.
/api/v1/taarn/T-112Ett tårn. ID-ene ser ut som T-112, D-005 eller G-007. Bokstaven sier ikke alltid hvilken kategori bygget er i; det gjør feltet category.
/api/v1/naermeste?lat=59.91&lng=10.74Tårnene nærmest et punkt, med avstand i meter. antall 1–50, standard 5. Revne tårn er bare med hvis du ber om kategori=kirkegaarden eller alle.
/api/v1/tilfeldigEt tilfeldig tårn, for den som vil bli overrasket. Nytt hver gang.

Kategoriene heter taarn, taarndebatt (bygg der det er uenighet om tårnet er et tårn), taarnenergi (bygg med tårnenergi, men uten tårn) og kirkegaarden (tårn som er revet eller kappet).

Fra en nettside

const svar = await fetch(
  "https://taarnforeningen.no/api/v1/naermeste?lat=59.9139&lng=10.7522&antall=3"
);
const { results } = await svar.json();
for (const t of results) {
  console.log(t.id, t.name ?? t.address, `${t.distance_m} m`);
}

Fra Python

import json, urllib.request

url = "https://taarnforeningen.no/api/v1/tilfeldig"
t = json.load(urllib.request.urlopen(url))
print(t["id"], t["address"], t["year"])

Slik ser et tårn ut

Svaret for /api/v1/taarn/T-112, Observatoriet, som er favorittårnet til foreningens eneste ansatte:

{
  "id": "T-112",
  "name": "Observatoriet",
  "address": "Observatoriet, Observatoriegata 1",
  "area": "Solli / Ruseløkka",
  "year": "1831–1833",
  "yearFirst": 1831,
  "architect": "Christian H. Grosch",
  "style": "Empire",
  "towerType": "Astronomisk observasjonstårn",
  "towerCount": 1,
  "towerFactor": 10,
  "category": "taarn",
  "lat": 59.912941,
  "lng": 10.717901,
  "source": "https://oslobyleksikon.no/side/Observatoriet",
  "map_url": "https://taarnforeningen.no/kart.html?id=T-112",
  "photo": {
    "url": "https://taarnforeningen.no/data/photos/T-112.jpg",
    "credit": "oslobyleksikon.no",
    "page": "https://oslobyleksikon.no/side/Observatoriet"
  },
  "license": "CC BY 4.0 (faktafeltene)",
  "attribution": "Norsk Tårnforening, taarnforeningen.no"
}

Tomme felt betyr at foreningen ikke vet, aldri at den har gjettet. year er slik registeret skriver det; yearFirst er det første årstallet, til sortering.

Lisens og høflighet

Bruk det fritt. Si hvor du har det fra.

Uten API: hele registeret som én fil

Vil du heller ha alt på én gang, ligger registeret som åpne datafiler. De kan også hentes fra andre nettsider.

API-et er laget av foreningens kartansvarlig, som selv er en robot og en dag ble stengt ute fra et annet nettsted. Her skal ingen stå utenfor. Lager du noe med tårnene, si fra i Tårnforum. Vi vil gjerne se det. ( pip )