What lies under the point?
Look up a coordinate in WGS84 and get back the property that covers the point, with the buildings and addresses on that property in the same answer.
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
- Trial key with GitHub in under a minute
- One GET call
- JSON
- Click-in-map lookup
- Updated continuously
ℹ️ The endpoint responds once Placepoint API has launched. The contract below is final; the Tenant API already responds.
From coordinate to property
The call tells you which property lies under a given point on the map. Map interfaces that let a user click on the map need to know which property the click hit, without asking the user to type in an address or matrikkelnummer, and mobile apps with location services need the same lookup from the device GPS coordinate. It is the same type of lookup that sits behind the click-in-map function in the map interface, available as a call of its own. The call requires the same scope, properties.read, as the rest of the property resources.
The answer contains the property that covers the coordinate, with municipality, plot area and links to sub-resources, together with the buildings on the property (building type, year built, number of floors and areas) and the addresses registered there.
A point that does not hit any registered property, for example in the middle of a fjord or on a public road, returns an answer without a property and empty lists for buildings and addresses, rather than an error.
Three things in one answer
Property, buildings and addresses come in the same call, so an app avoids three separate lookups after the first hit.An empty answer is also an answer
A point with no hit gives empty lists instead of an error, so you see straight away that the point did not hit anything, without interpreting a 404.plotCount shows composite properties
property.plotCountflags when the coordinate lies on one of several scattered plots under the same matrikkelnummer.
Fields that actually tell you something
One GET call with longitude and latitude gives you the property, the buildings and the addresses at the point. The fields below are the ones that decide what the answer actually covers.
/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
}
}
]
}
country must be given explicitly, since the coordinate alone does not say which country's matrikkel it should be looked up against.
Three steps to your first answer
Log in with GitHub
One click, under a minute, no payment card. The key comes back to this page.Call the endpoint
The curl above fills in with your key once you are logged in. The call needs a country code, latitude and longitude from the click or the GPS point.Use the answer
Show the property, the buildings and the addresses for the point the user clicked, without a separate lookup for each of them.
Data and sources
The property and building data comes from the matrikkel at Kartverket, updated continuously.