Var går gränsen?

Fastighetens registrerade gräns som GeoJSON i WGS84, klar att ritas direkt in i en karta utan en separat omräkning från UTM först.

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

• Testnyckel med GitHub på under en minut
• Ett GET-anrop
• GeoJSON
• WGS84
• Uppdaterad löpande

ℹ️ Slutpunkten svarar när Placepoint API är lanserat. Kontraktet nedan är slutgiltigt. Hyresgäst-API svarar redan.

Från matrikkelnummer till tomtgräns

Anropet svarar på exakt var en fastighet går i terrängen, som geometri och inte bara som text. Utvecklare som bygger egna kartgränssnitt behöver gränsen som en polygon att rita, mäklare som gör kartutsnitt till en objektbeskrivning slipper rita gränsen för hand, och kommuner som jämför egna plandata mot Placepoints kopia behöver samma geometri på båda ställena.

Svaret är ett enkelt GeoJSON-objekt: type är alltid Feature, geometry är en Polygon i WGS84, och properties är tom för en fastighetsgräns. En byggnads grundritning fyller samma fält med höjd och antal våningar i stället, se Byggnadsomriss.

Geometrin kommer från samma matrikkel- och FKB-underlag som kartgränssnittet ritar själv, så en fastighet ser identisk ut i din egen applikation som i Placepoint Fusion.

• GeoJSON i WGS84, klar att rita

  Ingen separat omräkning från UTM. Geometrin läggs direkt i ett kartlager, i samma koordinatsystem som de flesta kartbibliotek och mobila enheter redan räknar i.

• Samma underlag som kartgränssnittet

  Gränsen kommer från samma matrikkel- och FKB-underlag som kartgränssnittet ritar, så fastigheten ser identisk ut på båda ställena.

• En geometri per fastighet

  En fastighet med flera skiften (sammanhängande markområden) returnerar en samlad geometri, inte en per skifte, så du slipper slå samman dem själv.

Fält som faktiskt säger något

Ett GET-anrop med matrikkelnummeret ger gränsen. Fälten nedan är de tre som utgör hela GeoJSON-svaret.

GET/properties/{country}/{cadastreId}/boundary

curl -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": {}
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (3)

Felt	Type	Beskrivelse
type	string	Always "Feature".
geometry	object	GeoJSON geometry object.
properties	object	Feature properties. A building footprint carries heightM (number, meters) and floors (integer); a property boundary leaves this empty.

Gränsen kan ritas direkt i ett 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 till första svaret

1. Logga in med GitHub

   Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till den här sidan.

2. Anropa slutpunkten

   Curl-anropet ovan fylls ut med din nyckel när du är inloggad. Anropet behöver bara landskod och matrikkelnummer.

3. Använd svaret

   Lägg GeoJSON-objektet direkt i ditt kartbibliotek som en källa, så som kodsnutten ovan visar för MapLibre GL JS.

Data och källor

Gränserna kommer från matrikkelen hos Kartverket, uppdaterad löpande genom Geonorge.

Se även

• Kartgränssnittet
• Teknisk referens
• Placepoint API

Frågor och svar

Vilket koordinatsystem kommer geometrin i?

WGS84, samma system som de flesta kartbibliotek och mobila enheter räknar i. Ingen omräkning från UTM behövs innan geometrin läggs i ett kartlager.

Täcker ni alla kommuner?

Inte ännu. Gränsdata är ännu inte tillgängliga för alla kommuner, och en fastighet i en kommun utan täckning ger 404 i stället för en tom geometri.

Hur färska är data?

Gränserna kommer från matrikkelen hos Kartverket, uppdaterad löpande genom Geonorge.

Vad händer med en fastighet som har flera skiften?

Anropet ger gränsen för hela fastigheten som ett objekt. En fastighet med flera skiften returnerar en samlad geometri, inte en per skifte.

Rita fastighetsgränsen i din egen karta

Ett GET-anrop ger gränsen som GeoJSON i WGS84, klar för ett kartbibliotek. Logga in med GitHub högst upp på sidan för att prova det i dag, eller kontakta oss för åtkomst till hela landet.

Logg inn med GitHub