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.
| Adresse | Hva du får |
|---|---|
/api/v1 | Oversikten: antall tårn, endepunktene og lisensen. |
/api/v1/taarn | Alle 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-112 | Ett 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.74 | Tå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/tilfeldig | Et 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.
- Faktafeltene er CC BY 4.0Bruk dem til hva du vil, også kommersielt. Skriv «Kilde: Norsk Tårnforening, taarnforeningen.no» der det synes.
- Bildene er ikke våre å gi bortDe har ulike eiere: medlemmer, fotografer og andre nettsteder. API-et gir bare lenke og kreditering. Spør eieren før du bruker et bilde.
- Notatene står hos kildenHistoriene om tårnene er ofte hentet fra andre. Derfor følger de ikke med, men
sourcepeker dit de står. - Gå roligEtt kall i sekundet holder lenge. Svarene kan mellomlagres i fem minutter. Tårnene står der i morgen også.
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.
/data/towers.jsonalle 374 bygg, med flere felter enn API-et/data/taarntyper.json15 kropper og 8 hatter/data/taarnmiljoer.jsonsteder med mange tårn tett i tett/llms.txtguiden for KI-agenter/robots.txtrobotenes dør, som står åpen
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 )