Hoppa till innehåll
Lägeskollen

LägesKollen API v1 · spec-version 1.0.0

API-referens

Accessibility- och location-feature-data för svenska adresser (B2B). Decision-support, EJ sole-source AVM (CRR3 Art. 208(3)(b)). Kalibrering (vikter/baselines) = IP, exponeras ej. Kontakt: niclasg94@gmail.com.

OpenAPI-spec (JSON)Metodik (maskinläsbar)AnvändarvillkorMin användning

Autentisering & kvoter

Authorization: Bearer <nyckel> — hämta en gratis utvecklarnyckel (60 anrop/min). Utan nyckel: demo-endpointen /api/demo/features (10 anrop/min, max 50/dygn; kalibrerings-metadata utelämnas). Pilot-/licensavtal ger volymanpassad kvot. Tips: importera OpenAPI-specen direkt i Postman/Insomnia.

get/api/v1/features

Accessibility-features per svensk adress (B2B, decision-support).

Parametrar

NamnITypBeskrivning
addressquerystring
adressquerystring
latquerynumber
lonquerynumber

Svar 200 — OK

V1FeaturesResponse object
  • input* object
    • adress* string | null
    • lat* number
    • lon* number
    • resolved_from* string — — ett av: coords, geocoding
  • cell* object
    • cell_id* string
    • cell_id_raw* number
    • lat* number
    • lon* number
  • features* object
    • hansen_a_bil* number | null
    • hansen_a_transit* number | null
    • hansen_a_composite* number | null
    • jobs_30min_bil* number | null
    • jobs_30min_transit* number | null
    • jobs_45min_bil* number | null
    • jobs_45min_transit* number | null
    • jobs_60min_bil* number | null
    • jobs_60min_transit* number | null
    • ptal_score* number | null
    • ptal_grade* string | null
    • ptal_ai number | null
    • ptal_percentile_national object | null
      • score* number · ex: 87
      • percentile* number · ex: 0.87
      • grade* string · ex: "B"
  • data_quality* object
    • transit_coverage* string — — ett av: ok, no_itineraries_found, unprocessed
    • transit_note* string | null
    • bil_band_note* string | null
  • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
  • formula* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
  • confidence* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
  • location_scores* object
    • tillganglighet* object
      • raw* number
      • national* object | null — Riks-percentil (bank-portfölj).
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null — Region_typ-percentil (lokalt rättvist).
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • amenity* object | null
      • categories* object — Per kategori (dagligvaror, handel, halsa_vard, fritid, kultur, natur, kollektivtrafik, skola_familj).
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • character* object | null
      • vibrans* object
        • raw* number
        • national* object | null
          • score* number · ex: 87
          • percentile* number · ex: 0.87
          • grade* string · ex: "B"
        • local* object | null
          • score* number · ex: 87
          • percentile* number · ex: 0.87
          • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • natur* object | null
      • coverage* object
        • inner* number — Andel natur 0–200 m (0–1, NMD).
        • mid* number
        • outer* number
        • waterInner* number
        • waterMid* number
        • waterOuter* number
      • raw* number · ex: 47 — NMD viktad ring-täckning 0–100 (absolut).
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • provenance* object
        • source* string
        • nmd_version* string | null
        • distance_to_grid_m* number | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • vatten* object | null
      • distWaterM* number | null · ex: 120 — Avstånd till närmaste vatten (m, NMD2018).
      • raw* number · ex: 0.83 — Närhet exp(−λ·dist) ∈ (0,1].
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • vatten_utsikt* object | null
      • fracPot* number · ex: 0.089 — Synlig vatten-AREA-andel, topp-våning (potential) ∈ [0,1] (viewshed).
      • fracMin* number · ex: 0.012 — Synlig vatten-AREA-andel, marknivå (minimum) ∈ [0,1].
      • potential* object | null — Score topp-våning: 0 = ingen utsikt, annars percentil bland seende.
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • minimum* object | null — Score marknivå = garanterad undre gräns.
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • reach* object | null
      • mode* string — — ett av: walk
      • categories* object — Per amenity-kategori (samma vokabulär som amenity). Kategori utan POI i något band utelämnas.
      • method* string · ex: "isochrone_poi_containment_v1"
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • socioekonomi* object | null
      • raw* number — RÅ SCB socioek-index (Delmos/SCB TAB6586); skala ~0–100, HÖGRE = SÄMRE. Scoren inverterar.
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • regso_code* string | null
      • method* string
      • komponenter* object — Transparenta delkomponenter (fakta, ej i scoren).
        • median_income* number | null
        • pct_higher_education* number | null
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • trygghet* object | null
      • raw* number — RÅ bostadsinbrott/100k (Brå); HÖGRE = SÄMRE. Scoren inverterar. ⚠️ mörkertal + kommun-nivå.
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • municipality_code* string | null
      • method* string
      • komplement_fakta* object — Transparenta komplement-fakta (stöld/våld/NTU/trend), ej i scoren.
        • property_per100k* number | null
        • violent_per100k* number | null
        • insecurity_pct* number | null
        • worry_pct* number | null
        • trend* string | null
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
  • flood* object
    • coverage* string — — ett av: mapped, no_hit, unknown
    • scenarios_present* array av string
      • [element] string
    • lowest_return_period_years* number | null
    • annual_exceedance_probability* number | null
    • flood_type* string | null
    • watercourse* string | null
    • discharge_scenarios* array av object
      • [element] object
    • climate_adjusted objekt
    • provenance* object
    • notes* object
  • perf* object
    • total_ms* number
  • disclaimer* string

Svar 400 — missing_parameters / geocoding_failed / coords_outside_sweden

Error object
  • error* string
  • message string

Svar 401 — unauthorized (strict-läge: Bearer krävs)

Error object
  • error* string
  • message string

Svar 404 — no_cell_within_1km / no_cell_scores

Error object
  • error* string
  • message string

Svar 429 — rate_limit_exceeded (60/min)

Error object
  • error* string
  • message string

get/api/demo/features

Demo av v1/features (pitch, rate-limit 10/min, ingen auth).

Parametrar

NamnITypBeskrivning
addressquerystring
adressquerystring
latquerynumber
lonquerynumber

Svar 200 — OK

V1FeaturesResponse object
  • input* object
    • adress* string | null
    • lat* number
    • lon* number
    • resolved_from* string — — ett av: coords, geocoding
  • cell* object
    • cell_id* string
    • cell_id_raw* number
    • lat* number
    • lon* number
  • features* object
    • hansen_a_bil* number | null
    • hansen_a_transit* number | null
    • hansen_a_composite* number | null
    • jobs_30min_bil* number | null
    • jobs_30min_transit* number | null
    • jobs_45min_bil* number | null
    • jobs_45min_transit* number | null
    • jobs_60min_bil* number | null
    • jobs_60min_transit* number | null
    • ptal_score* number | null
    • ptal_grade* string | null
    • ptal_ai number | null
    • ptal_percentile_national object | null
      • score* number · ex: 87
      • percentile* number · ex: 0.87
      • grade* string · ex: "B"
  • data_quality* object
    • transit_coverage* string — — ett av: ok, no_itineraries_found, unprocessed
    • transit_note* string | null
    • bil_band_note* string | null
  • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
  • formula* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
  • confidence* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
  • location_scores* object
    • tillganglighet* object
      • raw* number
      • national* object | null — Riks-percentil (bank-portfölj).
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null — Region_typ-percentil (lokalt rättvist).
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • amenity* object | null
      • categories* object — Per kategori (dagligvaror, handel, halsa_vard, fritid, kultur, natur, kollektivtrafik, skola_familj).
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • character* object | null
      • vibrans* object
        • raw* number
        • national* object | null
          • score* number · ex: 87
          • percentile* number · ex: 0.87
          • grade* string · ex: "B"
        • local* object | null
          • score* number · ex: 87
          • percentile* number · ex: 0.87
          • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • natur* object | null
      • coverage* object
        • inner* number — Andel natur 0–200 m (0–1, NMD).
        • mid* number
        • outer* number
        • waterInner* number
        • waterMid* number
        • waterOuter* number
      • raw* number · ex: 47 — NMD viktad ring-täckning 0–100 (absolut).
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • provenance* object
        • source* string
        • nmd_version* string | null
        • distance_to_grid_m* number | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • vatten* object | null
      • distWaterM* number | null · ex: 120 — Avstånd till närmaste vatten (m, NMD2018).
      • raw* number · ex: 0.83 — Närhet exp(−λ·dist) ∈ (0,1].
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • vatten_utsikt* object | null
      • fracPot* number · ex: 0.089 — Synlig vatten-AREA-andel, topp-våning (potential) ∈ [0,1] (viewshed).
      • fracMin* number · ex: 0.012 — Synlig vatten-AREA-andel, marknivå (minimum) ∈ [0,1].
      • potential* object | null — Score topp-våning: 0 = ingen utsikt, annars percentil bland seende.
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • minimum* object | null — Score marknivå = garanterad undre gräns.
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • method* string
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • reach* object | null
      • mode* string — — ett av: walk
      • categories* object — Per amenity-kategori (samma vokabulär som amenity). Kategori utan POI i något band utelämnas.
      • method* string · ex: "isochrone_poi_containment_v1"
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • socioekonomi* object | null
      • raw* number — RÅ SCB socioek-index (Delmos/SCB TAB6586); skala ~0–100, HÖGRE = SÄMRE. Scoren inverterar.
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • regso_code* string | null
      • method* string
      • komponenter* object — Transparenta delkomponenter (fakta, ej i scoren).
        • median_income* number | null
        • pct_higher_education* number | null
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
    • trygghet* object | null
      • raw* number — RÅ bostadsinbrott/100k (Brå); HÖGRE = SÄMRE. Scoren inverterar. ⚠️ mörkertal + kommun-nivå.
      • national* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • local* object | null
        • score* number · ex: 87
        • percentile* number · ex: 0.87
        • grade* string · ex: "B"
      • region_typ* string | null
      • municipality_code* string | null
      • method* string
      • komplement_fakta* object — Transparenta komplement-fakta (stöld/våld/NTU/trend), ej i scoren.
        • property_per100k* number | null
        • violent_per100k* number | null
        • insecurity_pct* number | null
        • worry_pct* number | null
        • trend* string | null
      • metadata* object — Audit-trail-metadata (method-id, källor, proveniens). Freeform; kalibrering exponeras ej.
      • confidence object
        • level* string — Härledd ur metodvaliderings-nivå (model cards) + datatäcknings-signaler. Regler auditbara. — ett av: high, medium, low
        • drivers* array av string — Maskinläsbara nedgraderings-orsaker (t.ex. rural_osm_coverage, transit_no_itineraries).
          • [element] string
  • flood* object
    • coverage* string — — ett av: mapped, no_hit, unknown
    • scenarios_present* array av string
      • [element] string
    • lowest_return_period_years* number | null
    • annual_exceedance_probability* number | null
    • flood_type* string | null
    • watercourse* string | null
    • discharge_scenarios* array av object
      • [element] object
    • climate_adjusted objekt
    • provenance* object
    • notes* object
  • perf* object
    • total_ms* number
  • disclaimer* string

Svar 429 — rate_limit_exceeded (10/min)

Error object
  • error* string
  • message string

get/api/v1/health

Hälso-/status-check.

Svar 200 — OK

object
  • status* string

get/api/v1/methodology

Publik metod-familj + källor (ingen kalibrering).

Svar 200 — OK

object

Felkoder

StatuserrorÅtgärd
400missing_parameters / geocoding_failed / valideringsfelKontrollera address alt. lat+lon; felmeddelandet anger orsaken.
401unauthorizedGiltig Bearer-nyckel krävs (strict-läge). Hämta gratis utvecklarnyckel på /tjanster/api.
429rate_limit_exceededKvot nådd — fältet limit anger minute/daily/global_daily; respektera Retry-After-headern.
500internalTillfälligt fel — försök igen; kvarstår det, mejla kontakt@lageskollen.se.

Referensen genereras ur samma OpenAPI-spec som serveras på /api/v1/openapi.json. Svarens metadata-fält bär metod, källor och begränsningar per kategori; exakta kalibreringsparametrar delas under pilot-/licensavtal (läs mer).