Kvar går grensa?
Eigedomens registrerte grense som GeoJSON i WGS84, klar til å teiknast rett inn i eit kart utan ei eiga omrekning frå 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 eitt minutt
- Eitt GET-kall
- GeoJSON
- WGS84
- Oppdatert løpande
ℹ️ Endepunktet svarar når Placepoint API er lansert. Kontrakten under er endeleg; Leigetakar-API svarar allereie.
Frå matrikkelnummer til tomtegrense
Kallet svarar på nøyaktig kvar ein eigedom går i terrenget, som geometri og ikkje berre som tekst. Utviklarar som byggjer eigne kartgrensesnitt treng grensa som ein polygon å teikne, meklarar som lagar kartutsnitt til ei salsoppgåve slepp å teikne grensa for hand, og kommunar som samanliknar eigne plandata mot kopien til Placepoint treng same geometri på begge stader.
Svaret er eitt enkelt GeoJSON-objekt: type er alltid Feature, geometry er ein Polygon i WGS84, og properties er tom for ei eigedomsgrense. Grunnrisset til eit bygg fyller det same feltet med høgd og etasjetal i staden, sjå Bygningsomriss.
Geometrien kjem frå same matrikkel- og FKB-grunnlag som kartgrensesnittet teiknar sjølv, så ein eigedom ser identisk ut i eigen applikasjon som i Placepoint Fusion.
GeoJSON i WGS84, ferdig å teikne
Inga eiga omrekning frå UTM. Geometrien blir lagd rett i eit kartlag, i same koordinatsystem som dei fleste kartbibliotek og mobileiningar allereie reknar i.Same grunnlag som kartgrensesnittet
Grensa kjem frå same matrikkel- og FKB-grunnlag som kartgrensesnittet teiknar, så eigedomen ser identisk ut på begge stader.Éin geometri per eigedom
Ein eigedom med fleire teigar returnerer éin samla geometri, ikkje éin per teig, så du slepp å slå dei saman sjølv.
Felt som faktisk seier noko
Eitt GET-kall med matrikkelnummeret gir grensa. Felta under er dei tre som utgjer heile 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": {}
}
Grensa kan teiknast direkte i eit 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
Eitt klikk, under eitt minutt, ingen betalingskort. Nøkkelen kjem tilbake til denne sida.Kall endepunktet
Curl-en over fyller seg ut med nøkkelen din når du er logga inn. Kallet treng berre landkode og matrikkelnummer.Bruk svaret
Legg GeoJSON-objektet rett i kartbiblioteket ditt som ei kjelde, slik snutten over viser for MapLibre GL JS.
Data og kjelder
Grensene kjem frå matrikkelen hos Kartverket, oppdatert løpande gjennom Geonorge.