Kva ligg under punktet?

Slå opp ein koordinat i WGS84 og få eigedommen som dekkjer punktet tilbake, med bygningane og adressene på eigedommen i same svar.

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
• JSON
• Klikk-i-kart-oppslag
• Oppdatert løpande

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

Frå koordinat til eigedom

Kallet svarar på kva for ein eigedom som ligg under eit gitt punkt i kartet. Kartgrensesnitt som lèt ein brukar klikke i kartet treng å vite kva for ein eigedom klikket trefte, utan å be brukaren skrive inn adresse eller matrikkelnummer sjølv, og mobilappar med posisjonsteneste treng same oppslag frå GPS-koordinaten til eininga. Det er same type oppslag som ligg bak klikk-i-kartet-funksjonen i kartgrensesnittet, tilgjengeleg som eige kall. Kallet krev same scope, properties.read, som resten av eigedomsressursane.

Svaret inneheld eigedommen som dekkjer koordinaten, med kommune, tomteareal og lenkjer til underressursar, saman med bygga på eigedommen (byggjetype, byggjeår, etasjetal og areal) og adressene som er registrerte der.

Eit punkt som ikkje treffer nokon registrert eigedom, til dømes midt i ein fjord eller på ein offentleg veg, gir eit svar utan eigedom og tomme lister for bygningar og adresser, i staden for ein feil.

• Tre ting i eitt svar

  Eigedom, bygg og adresser kjem i same kall, så ein app slepp tre separate oppslag etter det første treffet.

• Tomt svar er òg eit svar

  Eit punkt utan treff gir tomme lister i staden for ein feil, så du ser med ein gong at punktet ikkje trefte noko, utan å tolke ein 404.

• plotCount viser samansette eigedommar

  property.plotCount flaggar når koordinaten ligg på ein av fleire spreidde teigar under same matrikkelnummer.

Felt som faktisk seier noko

Eitt GET-kall med lengde- og breiddegrad gir eigedommen, bygga og adressene på punktet. Felta under er dei som avgjer kva svaret faktisk dekkjer.

GET/coordinates/{country}/{lat}/{lon}

curl -X GET "https://data.placepoint.no/coordinates/NO/59.9075/10.7563" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "property": {
    "country": "NO",
    "cadastreId": "0301-207-76-0-0",
    "municipality": {
      "code": "0301",
      "name": "Oslo"
    },
    "areaM2": 620,
    "plotCount": 1,
    "propertyType": "EIERSEKSJON",
    "addresses": [
      {
        "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
        }
      }
    ],
    "links": [
      {
        "href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/sections",
        "title": "Sections"
      },
      {
        "href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/buildings",
        "title": "Buildings"
      },
      {
        "href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/units",
        "title": "Units"
      }
    ]
  },
  "buildings": [
    {
      "buildingNumber": "1",
      "buildingType": {
        "code": "141",
        "name": "Boligblokk"
      },
      "status": "IN_USE",
      "builtYear": 2015,
      "floors": 12,
      "grossAreaM2": 8400,
      "usableAreaM2": 7600,
      "footprintM2": 700,
      "location": {
        "lat": 59.9075,
        "lon": 10.7563
      }
    }
  ],
  "addresses": [
    {
      "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 (127)

Felt	Type	Beskrivelse
property.country	string	ISO 3166-1 alpha-2.
property.cadastreId	string	Cadastre identifier.
property.municipality.code	string	Kommunenummer (Norway) or kommunkod (Sweden).
property.municipality.name	string	Name.
property.municipality.countyName	string	Fylke (Norway) or län (Sweden) the municipality belongs to.
property.municipality.cityDistrictName	string	Bydel, where the municipality is divided into them.
property.areaM2	number	Registered plot area in square meters.
property.plotCount	integer	Number of teiger.
property.buildingCount	integer	Buildings registered on the property.
property.sectionCount	integer	Eierseksjoner registered on the property.
property.unitCount	integer	Bruksenheter across the buildings.
property.housingUnitCount	integer	Dwelling units across the buildings.
property.totalUsableAreaM2	number	Usable floor area (bruksareal) summed over the buildings, in square meters.
property.totalGrossAreaM2	number	Gross floor area (bruttoareal) summed over the buildings, in square meters.
property.builtOverAreaM2	number	Built-over area (bebygd areal, BYA) in square meters.
property.builtOverAreaPct	number	Built-over area as a percentage of the plot area.
property.averageFloors	number	Average floor count across the buildings.
property.taxationValue.amount	string	Decimal string, e.g. "12500000.00".
property.taxationValue.currency	string	ISO 4217, e.g. NOK or SEK.
property.establishedDate	string	When the cadastral unit was established in the register.
property.location.lat	number	Latitude.
property.location.lon	number	Longitude.
property.addresses[].text	string	One-line address.
property.addresses[].streetName	string	Street.
property.addresses[].houseNumber	string	Number with letter.
property.addresses[].postalCode	string	Postal code.
property.addresses[].postalPlace	string	Postal place.
property.addresses[].country	string	ISO 3166-1 alpha-2.
property.addresses[].cadastreId	string	The property the address belongs to.
property.addresses[].location.lat	number	Latitude.
property.addresses[].location.lon	number	Longitude.
property.propertyType	string	Register type.
property.facilityType.code	string	Register code.
property.facilityType.name	string	Type name.
property.facilityType.description	string	What the type covers.
property.purposeType.code	string	Register code.
property.purposeType.name	string	Purpose name.
property.purposeType.description	string	What the purpose covers.
property.otherUnitTypeCode	string	Register code for a unit type that is none of the standard property types.
property.landRegistryName	string	Name the grunnbok carries for the unit, where it differs from the address.
property.landUse	string	Dominant AR5 land-use class over the property's teiger. The set follows AR5 and grows; treat an unknown value as OTHER.
property.leaseholdCount	integer	Active leasehold plots (festetomter) on the property.
property.hasParkingGarage	boolean	Whether a parking garage is registered on the property.
property.historicalReportedAreaM2	number	Previously reported plot area in square meters, where the register has revised it.
property.historicalReportedAreaSourceCode	string	Register code for where the historical area came from.
property.tenantSummary.companyCount	integer	Companies registered at the property.
property.tenantSummary.companiesWithEmployeesCount	integer	Of those, how many report at least one employee.
property.tenantSummary.employeeCount	integer	Employees summed over those companies.
property.supplements.hasGroundPollution	boolean	Ground pollution is registered on the unit.
property.supplements.hasCulturalHeritage	boolean	A cultural-heritage interest is registered on the unit.
property.supplements.hasNotedComplaint	boolean	A complaint (klage) is noted on the unit.
property.supplements.hasActiveLeaseholdPlots	boolean	The unit has active leasehold plots.
property.supplements.hasAgreementBoundaryPointLease	boolean	An agreement on boundary or point lease is registered.
property.supplements.hasAgreementSiteSpecificRight	boolean	A site-specific right is registered by agreement.
property.supplements.pointLease	boolean	The unit is a point lease (punktfeste).
property.supplements.clarifiedOwners	boolean	Ownership has been clarified.
property.supplements.clarifiedShares	boolean	Ownership shares have been clarified.
property.supplements.sectioned	boolean	The unit is divided into eierseksjoner.
property.supplements.additionalArea	boolean	Additional area (tilleggsareal) is registered.
property.supplements.newlyRegistered	boolean	The unit was recently registered.
property.supplements.discontinued	boolean	The unit has been discontinued (utgått).
property.supplements.underMergerRemains	boolean	The unit remains after a merger (sammenslåing).
property.supplements.underMergerExpires	boolean	The unit expires through a merger.
property.supplements.partOfConsolidatedRealEstate	boolean	The unit is part of a consolidated property.
property.supplements.createdOnASeparateBasis	boolean	The unit was created on a separate basis.
property.supplements.landAcquisitionRegistered	boolean	A land acquisition is registered.
property.supplements.landPartitioningRequiredRegistered	boolean	Required land partitioning is registered.
property.supplements.measurementNotCompleted	boolean	Surveying of the unit is not completed.
property.supplements.borderPointMarkingIsMissing	boolean	Boundary-point marking is missing.
property.supplements.cadastralRecordingDeficiency	boolean	A deficiency in the cadastral recording is registered.
property.supplements.registryOfDeeds	boolean	The unit is recorded in the older registry of deeds (grunnboksblad).
property.links[].href	string	Absolute URL.
property.links[].title	string	Human label.
buildings[].buildingNumber	string	Bygningsnummer within the property.
buildings[].buildingType.code	string	Register type code, e.g. "141".
buildings[].buildingType.name	string	Type name, e.g. Boligblokk.
buildings[].buildingType.primaryCode	string	Primary type code, the first level of the register's own two-level classification.
buildings[].buildingType.subCode	string	Sub-type code within the primary code.
buildings[].status	string	Construction status.
buildings[].builtYear	integer	Year the building was completed.
buildings[].floors	integer	Number of floors.
buildings[].grossAreaM2	number	Gross floor area (bruttoareal) in square meters.
buildings[].usableAreaM2	number	Usable floor area (bruksareal) in square meters.
buildings[].footprintM2	number	Ground footprint in square meters.
buildings[].residentialUsableAreaM2	number	Usable floor area used for housing, in square meters.
buildings[].otherUsableAreaM2	number	Usable floor area used for anything but housing, in square meters.
buildings[].builtOverAreaM2	number	Built-over area (bebygd areal, BYA) in square meters.
buildings[].builtOverAreaPct	number	Built-over area as a percentage of the plot area.
buildings[].dwellingUnitCount	integer	Dwelling units in the building.
buildings[].hasLift	boolean	Whether the building is registered with a lift.
buildings[].waterSupply	string	Registered water supply.
buildings[].sewerage	string	Registered sewerage.
buildings[].energySources[]	string[]	Registered energy sources.
buildings[].heatingTypes[]	string[]	Registered heating types.
buildings[].usageGroup	string	Industry group the registered building type belongs to.
buildings[].registrationOrigin	string	How the building entered the register.
buildings[].isCulturalHeritage	boolean	Whether the building is registered as a cultural heritage site.
buildings[].isSefrakRegistered	boolean	Whether the building is in SEFRAK, the register of buildings from before 1900.
buildings[].sequenceNumber	integer	The building's sequence number (løpenummer) within the property.
buildings[].extensionTypeCode	string	Register code for an extension (tilbygg) relationship to another building.
buildings[].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.
buildings[].isWithoutBuiltUpArea	boolean	Whether the building is registered as having no built-up area.
buildings[].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.
buildings[].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.
buildings[].elevation.baseElevationM	number	Ground elevation at the building, in meters above sea level.
buildings[].elevation.highestPointM	number	Highest measured point of the building, in meters above sea level.
buildings[].elevation.heightAboveGroundM	number	Building height above ground, in meters.
buildings[].statusHistory[].status	string	The status the building changed to.
buildings[].statusHistory[].changedDate	string	When the change took effect.
buildings[].statusHistory[].registeredDate	string	When the register recorded the change.
buildings[].statusHistory[].reason	string	Registered reason for the change, e.g. Ferdigattest.
buildings[].floorDetails[].floorNumber	integer	Floor number, negative below ground.
buildings[].floorDetails[].floorKind	string	Registered floor kind.
buildings[].floorDetails[].usableAreaM2	number	Usable floor area on the floor, in square meters.
buildings[].floorDetails[].roomCount	integer	Rooms on the floor.
buildings[].floorDetails[].dwellingUnitCount	integer	Dwelling units on the floor.
buildings[].location.lat	number	Latitude.
buildings[].location.lon	number	Longitude.
addresses[].text	string	One-line address.
addresses[].streetName	string	Street.
addresses[].houseNumber	string	Number with letter.
addresses[].postalCode	string	Postal code.
addresses[].postalPlace	string	Postal place.
addresses[].country	string	ISO 3166-1 alpha-2.
addresses[].cadastreId	string	The property the address belongs to.
addresses[].location.lat	number	Latitude.
addresses[].location.lon	number	Longitude.

country må oppgivast eksplisitt sidan koordinaten åleine ikkje fortel kva lands matrikkel han skal slåast opp mot.

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

   Curl-en over fyller seg ut med nøkkelen din når du er logga inn. Kallet treng landkode, breiddegrad og lengdegrad frå klikket eller GPS-punktet.

3. Bruk svaret

   Vis eigedommen, bygga og adressene for punktet brukaren klikka, utan eit eige oppslag for kvar av dei.

Data og kjelder

Eigedoms- og bygningsdataa kjem frå matrikkelen hos Kartverket, oppdatert løpande.

Sjå òg

• Søk
• Teknisk referanse
• Placepoint API

Spørsmål og svar

Kva koordinatsystem ventar kallet?

WGS84, same system som dei fleste kartbibliotek og mobileiningar allereie reknar i.

Kva skjer om koordinaten ikkje treffer nokon eigedom?

Kallet svarar med ein tom eigedomsverdi og tomme lister for bygningar og adresser, i staden for ein feil. Fråværet av treff er sjølve svaret.

Kor ferske er dataa?

Eigedoms- og bygningsdataa kjem frå matrikkelen hos Kartverket, oppdatert løpande.

Kva er skilnaden på dette og adressesøk?

Dette kallet går frå koordinat til eigedom. For søk frå ein tekststreng, sjå Adresser til matrikkelnummer, som løyser motsett veg: frå adressetekst til matrikkelnummer.

Slå opp eigedommen bak eit punkt i kartet

Eitt GET-kall gir eigedom, bygg og adresser for ein koordinat. 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