Kva står på tomta?

Bygningane på ein eigedom med byggjeår, etasjar og areal, og brukseiningane i dei: leilegheiter, kontor og liknande, med bruksareal og bruksformål.

Logg inn med GitHubSlik ser det ut ↓Teknisk referanse →

Nøkkelen virker i dag på Leietaker-API og dagens Data API; Placepoint API godtar samme nøkkel når det lanseres.

Prøv med et ekte bygg: Oslo S, Jernbanetorget 1

• Prøvenøkkel med GitHub på under eitt minutt
• Eitt GET-kall per liste
• Noreg og Sverige
• Kartverket-data
• Byggjeår og status

ℹ️ Endepunktet svarar når Placepoint API er lansert. Kontrakten under er endeleg; Leigetakar-API svarar allereie.

Frå matrikkelnummer til bygg og brukseiningar

Bygningslista svarar på kva som faktisk står på tomta: talet på bygg, byggjeår, status og areal per bygg. Utbyggjarar brukar det til å vurdere eksisterande bygningsmasse før eit prosjekt; forvaltarar brukar det til å halde porteføljedata oppdatert utan å slå opp kvart bygg manuelt i Matrikkelen.

Brukseiningslista svarar på korleis bygningane er delte opp innvendig: brukseiningsnummer, etasje, areal og bruksformål. For næringseigedom er dette grunnlaget for å forstå utleigestrukturen; for bustad viser det tal og storleik på leilegheitene.

• Byggjeår og status utan å slå opp Matrikkelen manuelt

  Talet på bygg, byggjeår, status og areal for heile eigedommen i éi liste, i staden for eitt oppslag per bygg.

• Bruksformål per brukseining

  Brukseiningslista gjev brukseiningsnummer, etasje, areal og bruksformål for kvar eining, grunnlaget for å forstå utleigestrukturen.

• Adresse per brukseining

  Kvar brukseining har si eiga adresse i svaret, ikkje berre fellesadressa til eigedommen.

Felt som faktisk seier noko

Bygningane på ein eigedom.

GET/properties/{country}/{cadastreId}/buildings

curl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0/buildings" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "items": [
    {
      "buildingNumber": "1",
      "buildingType": {
        "code": "141",
        "name": "Boligblokk"
      },
      "status": "IN_USE",
      "builtYear": 2015,
      "floors": 12,
      "grossAreaM2": 8400,
      "usableAreaM2": 7600,
      "footprintM2": 700,
      "residentialUsableAreaM2": 6900,
      "otherUsableAreaM2": 700,
      "builtOverAreaM2": 700,
      "builtOverAreaPct": 33.1,
      "dwellingUnitCount": 48,
      "hasLift": true,
      "waterSupply": "PUBLIC",
      "sewerage": "PUBLIC",
      "energySources": [
        "ELECTRICITY",
        "DISTRICT_HEATING"
      ],
      "heatingTypes": [
        "CENTRAL",
        "UNDERFLOOR"
      ],
      "usageGroup": "RESIDENTIAL",
      "registrationOrigin": "ORDINARY_REGISTRATION",
      "isCulturalHeritage": false,
      "isSefrakRegistered": false,
      "elevation": {
        "baseElevationM": 3.2,
        "highestPointM": 41.8,
        "heightAboveGroundM": 38.6
      },
      "statusHistory": [
        {
          "status": "UNDER_CONSTRUCTION",
          "changedDate": "2013-04-18",
          "registeredDate": "2013-04-22"
        },
        {
          "status": "IN_USE",
          "changedDate": "2015-08-27",
          "registeredDate": "2015-09-02",
          "reason": "Ferdigattest"
        }
      ],
      "floorDetails": [
        {
          "floorNumber": 1,
          "floorKind": "GROUND",
          "usableAreaM2": 640,
          "roomCount": 12,
          "dwellingUnitCount": 4
        },
        {
          "floorNumber": 2,
          "floorKind": "MAIN",
          "usableAreaM2": 610,
          "roomCount": 14,
          "dwellingUnitCount": 4
        }
      ],
      "location": {
        "lat": 59.9075,
        "lon": 10.7563
      }
    }
  ]
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (45)

Felt	Type	Beskrivelse
items[].buildingNumber	string	Bygningsnummer within the property.
items[].buildingType.code	string	Register type code, e.g. "141".
items[].buildingType.name	string	Type name, e.g. Boligblokk.
items[].buildingType.primaryCode	string	Primary type code, the first level of the register's own two-level classification.
items[].buildingType.subCode	string	Sub-type code within the primary code.
items[].status	string	Construction status.
items[].builtYear	integer	Year the building was completed.
items[].floors	integer	Number of floors.
items[].grossAreaM2	number	Gross floor area (bruttoareal) in square meters.
items[].usableAreaM2	number	Usable floor area (bruksareal) in square meters.
items[].footprintM2	number	Ground footprint in square meters.
items[].residentialUsableAreaM2	number	Usable floor area used for housing, in square meters.
items[].otherUsableAreaM2	number	Usable floor area used for anything but housing, in square meters.
items[].builtOverAreaM2	number	Built-over area (bebygd areal, BYA) in square meters.
items[].builtOverAreaPct	number	Built-over area as a percentage of the plot area.
items[].dwellingUnitCount	integer	Dwelling units in the building.
items[].hasLift	boolean	Whether the building is registered with a lift.
items[].waterSupply	string	Registered water supply.
items[].sewerage	string	Registered sewerage.
items[].energySources[]	string[]	Registered energy sources.
items[].heatingTypes[]	string[]	Registered heating types.
items[].usageGroup	string	Industry group the registered building type belongs to.
items[].registrationOrigin	string	How the building entered the register.
items[].isCulturalHeritage	boolean	Whether the building is registered as a cultural heritage site.
items[].isSefrakRegistered	boolean	Whether the building is in SEFRAK, the register of buildings from before 1900.
items[].sequenceNumber	integer	The building's sequence number (løpenummer) within the property.
items[].extensionTypeCode	string	Register code for an extension (tilbygg) relationship to another building.
items[].isAreaIncomplete	boolean	Whether the register itself flags the area figures as incomplete. When true, a zero or absent area means unmeasured rather than nothing built.
items[].isWithoutBuiltUpArea	boolean	Whether the building is registered as having no built-up area.
items[].hasSprinklerSystem	boolean	Whether the building is registered with an automatic fire-suppression system. Absent means no source covers the building, not that it has none.
items[].derivedUsage	string	What Placepoint's classifier reads the building as, from footprint, height and surroundings. Derived, not registered: buildingType is what the register says, and the two disagree most often on older commercial stock. The set grows; treat an unknown value as OTHER.
items[].elevation.baseElevationM	number	Ground elevation at the building, in meters above sea level.
items[].elevation.highestPointM	number	Highest measured point of the building, in meters above sea level.
items[].elevation.heightAboveGroundM	number	Building height above ground, in meters.
items[].statusHistory[].status	string	The status the building changed to.
items[].statusHistory[].changedDate	string	When the change took effect.
items[].statusHistory[].registeredDate	string	When the register recorded the change.
items[].statusHistory[].reason	string	Registered reason for the change, e.g. Ferdigattest.
items[].floorDetails[].floorNumber	integer	Floor number, negative below ground.
items[].floorDetails[].floorKind	string	Registered floor kind.
items[].floorDetails[].usableAreaM2	number	Usable floor area on the floor, in square meters.
items[].floorDetails[].roomCount	integer	Rooms on the floor.
items[].floorDetails[].dwellingUnitCount	integer	Dwelling units on the floor.
items[].location.lat	number	Latitude.
items[].location.lon	number	Longitude.

Brukseiningane på ein eigedom.

GET/properties/{country}/{cadastreId}/units

curl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0/units" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "items": [
    {
      "unitNumber": "H0301",
      "buildingNumber": "1",
      "floor": 8,
      "usableAreaM2": 74,
      "useType": "BOLIG",
      "cadastreId": "0301-207-76-0-44",
      "grossAreaM2": 81,
      "primaryRoomAreaM2": 70,
      "roomCount": 3,
      "bathroomCount": 1,
      "toiletCount": 1,
      "kitchenAccess": "OWN_KITCHEN",
      "ownershipForm": "FREEHOLD",
      "energyLabel": "C",
      "toBeDecommissioned": false,
      "address": {
        "text": "Dronning Eufemias gate 16, 0191 Oslo",
        "streetName": "Dronning Eufemias gate",
        "houseNumber": "16",
        "postalCode": "0191",
        "postalPlace": "Oslo",
        "country": "NO",
        "cadastreId": "0301-207-76-0-0",
        "location": {
          "lat": 59.9075,
          "lon": 10.7563
        }
      }
    }
  ]
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (27)

Felt	Type	Beskrivelse
items[].unitNumber	string	Bruksenhetsnummer, e.g. H0301.
items[].buildingNumber	string	The building the unit belongs to.
items[].floor	integer	Floor number.
items[].usableAreaM2	number	Usable area in square meters.
items[].useType	string	Registered use of the unit.
items[].cadastreId	string	The unit's own matrikkelnummer, where it is registered as a section.
items[].grossAreaM2	number	Gross area in square meters.
items[].primaryRoomAreaM2	number	Primary room area (P-ROM) in square meters.
items[].roomCount	integer	Rooms in the unit.
items[].bathroomCount	integer	Bathrooms in the unit.
items[].toiletCount	integer	Toilets in the unit.
items[].kitchenAccess	string	Registered kitchen access.
items[].ownershipForm	string	How the unit is owned.
items[].energyLabel	string	Energy label for the unit, where an energiattest exists.
items[].toBeDecommissioned	boolean	Whether the register has flagged the unit to be removed.
items[].bedroomCount	integer	Bedrooms in the unit, where roomCount counts all rooms.
items[].animalsAllowed	boolean	Whether the cooperative or association permits pets.
items[].cooperativeShareNumber	string	The unit's share number (andelsnummer) in its housing cooperative.
items[].address.text	string	One-line address.
items[].address.streetName	string	Street.
items[].address.houseNumber	string	Number with letter.
items[].address.postalCode	string	Postal code.
items[].address.postalPlace	string	Postal place.
items[].address.country	string	ISO 3166-1 alpha-2.
items[].address.cadastreId	string	The property the address belongs to.
items[].address.location.lat	number	Latitude.
items[].address.location.lon	number	Longitude.

Tre steg til første svar

1. Logg inn med GitHub

   Eitt klikk, under eitt minutt, ingen betalingskort. Nøkkelen kjem tilbake til denne sida.

2. Kall endepunktet

   Byt ut $TOKEN i curl-en over. Begge listene tek landkode og matrikkelnummer, same parametrar som eigedomsoppslaget.

3. Bruk svaret

   Bruk byggjeår og areal til porteføljedata, eller brukseiningslista til å forstå utleigestrukturen i bygget.

Data og kjelder

Bygnings- og brukseiningsdata kjem frå matrikkelen til Kartverket, oppdatert løpande.

Sjå også

• Bygningspanel
• Teknisk referanse
• Placepoint API

Spørsmål og svar

Kor ferske er dataa?

Matrikkelen til Kartverket blir oppdatert løpande.

Kva dekkjer de?

Bygningar og brukseiningar registrerte i Matrikkelen i Noreg, og det tilsvarande svenske byggregisteret via Combify.

Verkar det i Sverige?

Ja, via Combify mot det svenske byggregisteret.

Kva står i bruksarealet?

usableAreaM2 er bruksareal (BRA), det reelle innvendige arealet i bygget. grossAreaM2 er bruttoareal, heile bygningskroppen inkludert veggar.

Sjå kva som står på tomta

To lister, bygg og brukseiningar, med byggjeår, areal og bruksformål. Logg inn med GitHub øvst på sida for å prøve det i dag, eller ta kontakt for tilgang til heile landet.

Logg inn med GitHub