Start på adressen, ikke matrikkelnummeret

Send inn en adressetekst i Norge eller Sverige og få matrikkelnummer, postnummer og koordinat tilbake i samme svar, klart for kartlaget eller neste oppslag.

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 ett minutt
• Ett GET-kall
• Norge og Sverige
• Kartverket- og Lantmäteriet-data
• Koordinat i svaret

ℹ️ Endepunktet svarer når Placepoint API er lansert. Kontrakten under er endelig; Leietaker-API svarer allerede.

Fra adresse til matrikkelnummer

Kallet svarer på ett spørsmål: hvilken eiendom hører denne adressen til? Banker, meglere og utbyggere sitter ofte med en adresse fra et skjema, en kontrakt eller en henvendelse, og trenger matrikkelnummeret for å slå opp resten: eiendom, bygg, eiere og transaksjoner.

Adressen kan være norsk eller svensk; landet avgjør hvilket register svaret kommer fra, Kartverkets adresseregister eller Lantmäteriet via Combify. Svaret kommer med koordinat i samme kall, slik at et system kan gå rett videre til kartlaget uten et nytt oppslag.

• Tåler variasjon i skrivemåten

  Et manuelt oppslag krever ofte eksakt treff. Kallet matcher på adressetekst og returnerer beste treff først, så en liten forskjell i skrivemåte ikke gir null treff.

• Koordinat i samme svar

  Ingen egen geokodingstjeneste å slå opp mot etterpå. Koordinatet følger med i samme kall som matrikkelnummeret.

• Delvis adresse gir flere treff

  En ufullstendig adressetekst gir flere kandidater i samme svar i stedet for én feilmelding, så et system kan la brukeren velge riktig treff.

Felter som faktisk sier noe

Ett GET-kall med adresseteksten gir trefflisten under, med matrikkelnummer og koordinat på hvert treff.

GET/addresses/{country}/{address}

curl -X GET "https://data.placepoint.no/addresses/NO/Karl%20Johans%20gate%201%2C%20Oslo" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "items": [
    {
      "text": "Karl Johans gate 1, 0154 Oslo",
      "streetName": "Karl Johans gate",
      "houseNumber": "1",
      "postalCode": "0154",
      "postalPlace": "Oslo",
      "country": "NO",
      "cadastreId": "0301-207-419-0-0",
      "location": {
        "lat": 59.9111,
        "lon": 10.7528
      }
    }
  ]
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (9)

Felt	Type	Beskrivelse
items[].text	string	One-line address.
items[].streetName	string	Street.
items[].houseNumber	string	Number with letter.
items[].postalCode	string	Postal code.
items[].postalPlace	string	Postal place.
items[].country	string	ISO 3166-1 alpha-2.
items[].cadastreId	string	The property the address belongs to.
items[].location.lat	number	Latitude.
items[].location.lon	number	Longitude.

Svaret gir cadastreId direkte, matrikkelnummeret i Norge og en fastighetsbeteckning-slug i Sverige, klart til å brukes i de andre endepunktene uten omregning.

Tre steg til første svar

1. Logg inn med GitHub

   Ett klikk, under ett minutt, ingen betalingskort. Nøkkelen kommer tilbake til denne siden.

2. Kall endepunktet

   Bytt ut $TOKEN i curl-en over med nøkkelen din, og send adresseteksten som parameter.

3. Bruk svaret

   cadastreId i svaret går rett inn i eiendomsoppslaget, eller send koordinatet videre til kartlaget.

Data og kilder

Norske adresser kommer fra Kartverkets adresseregister, oppdatert løpende. Svenske adresser kommer fra Lantmäteriet via Combify, oppdatert løpende.

Se også

• Søk
• Teknisk referanse
• Placepoint API

Spørsmål og svar

Hvor ferske er dataene?

Kartverkets adresseregister oppdateres løpende. Svenske adresser kommer fra Lantmäteriet via Combify og oppdateres på samme måte.

Hva dekker dere?

Alle registrerte adresser i Norge og Sverige. En delvis adressetekst kan gi flere treff; velg riktig treff på cadastreId.

Virker det i Sverige?

Ja. Svenske adresser matches mot Lantmäteriets register via Combify, og svaret bruker de samme feltnavnene som det norske.

Hva slags matrikkelnummer får jeg tilbake?

cadastreId er allerede på riktig form: matrikkelnummer i Norge, fastighetsbeteckning-slug i Sverige. Ingen omregning nødvendig før du kaller de andre endepunktene.

Slå opp adressen, få matrikkelnummeret

Ett GET-kall gir matrikkelnummer, postnummer og koordinat i samme svar, i Norge og Sverige. Logg inn med GitHub øverst på siden for å prøve det i dag, eller ta kontakt for tilgang til hele landet.

Logg inn med GitHub