Hvor går grensen?
Eiendommens registrerte grense som GeoJSON i WGS84, klar til å tegnes rett inn i et kart uten en egen omregning fra UTM først.
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 ett minutt
- Ett GET-kall
- GeoJSON
- WGS84
- Oppdatert løpende
ℹ️ Endepunktet svarer når Placepoint API er lansert. Kontrakten under er endelig; Leietaker-API svarer allerede.
Fra matrikkelnummer til tomtegrense
Kallet svarer på nøyaktig hvor en eiendom går i terrenget, som geometri og ikke bare som tekst. Utviklere som bygger egne kartgrensesnitt trenger grensen som en polygon å tegne, meglere som lager kartutsnitt til en salgsoppgave slipper å tegne grensen for hånd, og kommuner som sammenligner egne plandata mot Placepoints kopi trenger samme geometri begge steder bruker.
Svaret er ett enkelt GeoJSON-objekt: type er alltid Feature, geometry er en Polygon i WGS84, og properties er tom for en eiendomsgrense. Et byggs grunnriss fyller det samme feltet med høyde og etasjetall i stedet, se Bygningsomriss.
Geometrien kommer fra samme matrikkel- og FKB-grunnlag som kartgrensesnittet tegner selv, så en eiendom ser identisk ut i egen applikasjon som i Placepoint Fusion.
GeoJSON i WGS84, ferdig å tegne
Ingen egen omregning fra UTM. Geometrien legges rett i et kartlag, i samme koordinatsystem de fleste kartbiblioteker og mobilenheter allerede regner i.Samme grunnlag som kartgrensesnittet
Grensen kommer fra samme matrikkel- og FKB-grunnlag som kartgrensesnittet tegner, så eiendommen ser identisk ut begge steder.Én geometri per eiendom
En eiendom med flere teiger returnerer én samlet geometri, ikke én per teig, så du slipper å slå dem sammen selv.
Felter som faktisk sier noe
Ett GET-kall med matrikkelnummeret gir grensen. Feltene under er de tre som utgjør hele GeoJSON-svaret.
/properties/{country}/{cadastreId}/boundarycurl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0/boundary" \
-H "Authorization: Bearer $TOKEN"
svar · 200
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
10.7561,
59.9074
],
[
10.7565,
59.9074
],
[
10.7565,
59.9077
],
[
10.7561,
59.9077
],
[
10.7561,
59.9074
]
]
]
},
"properties": {}
}
Grensen kan tegnes direkte i et kartbibliotek som MapLibre GL JS:
const res = await fetch(`${base}/properties/NO/${cadastreId}/boundary`, {
headers: { Authorization: `Bearer ${token}` },
});
const boundary = await res.json();
map.addSource("tomtegrense", { type: "geojson", data: boundary });
map.addLayer({
id: "tomtegrense-linje",
type: "line",
source: "tomtegrense",
paint: { "line-color": "#1d4ed8", "line-width": 2 },
});
Tre steg til første svar
Logg inn med GitHub
Ett klikk, under ett minutt, ingen betalingskort. Nøkkelen kommer tilbake til denne siden.Kall endepunktet
Curl-en over fyller seg ut med nøkkelen din når du er logget inn. Kallet trenger bare landkode og matrikkelnummer.Bruk svaret
Legg GeoJSON-objektet rett i kartbiblioteket ditt som en kilde, slik snutten over viser for MapLibre GL JS.
Data og kilder
Grensene kommer fra matrikkelen hos Kartverket, oppdatert løpende gjennom Geonorge.