Start på adressa, ikkje matrikkelnummeret

Send inn ein adressetekst i Noreg eller Sverige og få matrikkelnummer, postnummer og koordinat tilbake i same svaret, 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 eitt minutt
• Eitt GET-kall
• Noreg og Sverige
• Kartverket- og Lantmäteriet-data
• Koordinat i svaret

ℹ️ Endepunktet svarar når Placepoint API er lansert. Kontrakten under er endeleg; Leigetakar-API svarar allereie.

Frå adresse til matrikkelnummer

Kallet svarar på eitt spørsmål: kva for eigedom høyrer denne adressa til? Bankar, meklarar og utbyggjarar sit ofte med ei adresse frå eit skjema, ein kontrakt eller ei førespurnad, og treng matrikkelnummeret for å slå opp resten: eigedom, bygg, eigarar og transaksjonar.

Adressa kan vere norsk eller svensk; landet avgjer kva register svaret kjem frå, adresseregisteret til Kartverket eller Lantmäteriet via Combify. Svaret kjem med koordinat i same kallet, slik at eit system kan gå rett vidare til kartlaget utan eit nytt oppslag.

• Toler variasjon i skrivemåten

  Eit manuelt oppslag krev ofte eksakt treff. Kallet matchar på adressetekst og returnerer beste treff først, så ein liten skilnad i skrivemåte ikkje gir null treff.

• Koordinat i same svar

  Inga eiga geokodingsteneste å slå opp mot etterpå. Koordinatet følgjer med i same kall som matrikkelnummeret.

• Delvis adresse gir fleire treff

  Ein ufullstendig adressetekst gir fleire kandidatar i same svar i staden for éi feilmelding, så eit system kan la brukaren velje rett treff.

Felt som faktisk seier noko

Eitt GET-kall med adresseteksten gir trefflista under, med matrikkelnummer og koordinat på kvart 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 Noreg og ein fastighetsbeteckning-slug i Sverige, klart til å brukast i dei andre endepunkta utan omrekning.

Tre steg til første svar

1. Logg inn med GitHub

   Eitt klikk, under eitt minutt, ingen betalingskort. Nøkkelen kjem tilbake til denne sida.

2. Kall endepunktet

   Byt 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 eigedomsoppslaget, eller send koordinatet vidare til kartlaget.

Data og kjelder

Norske adresser kjem frå adresseregisteret til Kartverket, oppdatert løpande. Svenske adresser kjem frå Lantmäteriet via Combify, oppdatert løpande.

Sjå òg

• Søk
• Teknisk referanse
• Placepoint API

Spørsmål og svar

Kor ferske er dataa?

Adresseregisteret til Kartverket blir oppdatert løpande. Svenske adresser kjem frå Lantmäteriet via Combify og blir oppdaterte på same måten.

Kva dekkjer de?

Alle registrerte adresser i Noreg og Sverige. Ein delvis adressetekst kan gi fleire treff; vel rett treff på cadastreId.

Verkar det i Sverige?

Ja. Svenske adresser blir matcha mot registeret til Lantmäteriet via Combify, og svaret bruker dei same feltnamna som det norske.

Kva slags matrikkelnummer får eg tilbake?

cadastreId er allereie på rett form: matrikkelnummer i Noreg, fastighetsbeteckning-slug i Sverige. Inga omrekning er nødvendig før du kallar dei andre endepunkta.

Slå opp adressa, få matrikkelnummeret

Eitt GET-kall gir matrikkelnummer, postnummer og koordinat i same svar, i Noreg og Sverige. Logg inn med GitHub øvst på sida for å prøve det i dag, eller ta kontakt for tilgang til heile landet.

Logg inn med GitHub