Adresser

Søk, validering, geokoding og eiendomsinformasjon for norske adresser.

GET/v1/adresserSøk og autofullfør
POST/v1/adresser/validerValider og normaliser
GET/v1/geokodingKoordinat til adresse
GET/v1/eiendommer/{matrikkel}Eiendomsinformasjon

GET/v1/adresser

Søk og autofullfør

Søk mens brukeren skriver. Teller som 0,2 kall. Rangerer nærmeste først hvis «naer» er satt.

Spørringsparametre

sokstringpåkrevd
Søketekst, minst 2 tegn.
naerstring
«lat,lon» i WGS84.
kommunestring
Begrens til kommunenummer.
antallinteger
1–20. Standard 5.

forespørsel

curl "https://api.spireapi.com/v1/adresser?sok=storgt%205%20lillestr&antall=5" \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "data": [
    { "id": "adr_2000_storgata_5", "tekst": "Storgata 5, 2000 Lillestrøm", "postnummer": "2000", "poststed": "Lillestrøm", "kommune": { "nr": "3205", "navn": "Lillestrøm" }, "koordinat": { "lat": 59.95598, "lon": 11.04924 }, "treff": 0.97 }
  ]
}

POST/v1/adresser/valider

Valider og normaliser

Tar en fritekstadresse eller strukturerte felt og returnerer offisiell form med treffsikkerhet og forslag ved usikkerhet.

Kropp (JSON)

tekststring
Fritekst, f.eks. «Storgt 5 H0201, 2000 Lillestrøm».
gatestring
Alternativt strukturert: «gate», «nummer», «bokstav», «bruksenhet», «postnummer».

forespørsel

curl -X POST https://api.spireapi.com/v1/adresser/valider \
  -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" -d '{"tekst":"Storgt 5 H0201, 2000 Lillestrøm"}'

svar

{
  "gyldig": true,
  "treff": 0.96,
  "adresse": { "id": "adr_2000_storgata_5", "tekst": "Storgata 5, 2000 Lillestrøm", "bruksenhet": "H0201", "adressekode": "3205-12345", "matrikkel": "3205-81/140" },
  "forslag": []
}

GET/v1/geokoding

Koordinat til adresse

Nærmeste adresser til et punkt, med avstand i meter.

Spørringsparametre

latnumberpåkrevd
Breddegrad, WGS84.
lonnumberpåkrevd
Lengdegrad, WGS84.
antallinteger
1–10. Standard 1.

forespørsel

curl "https://api.spireapi.com/v1/geokoding?lat=59.956&lon=11.049" \
  -H "Authorization: Bearer sk_test_…"

svar

{ "data": [ { "id": "adr_2000_storgata_5", "tekst": "Storgata 5, 2000 Lillestrøm", "avstand_m": 4.2 } ] }

GET/v1/eiendommer/{matrikkel}

Eiendomsinformasjon

Gårds-, bruks-, feste- og seksjonsnummer, areal, bygninger og bygningstype. Hjemmelshaver vises bare når det er tillatt for ditt formål.

Stiparametre

matrikkelstringpåkrevd
Format «kommunenr-gnr/bnr[/fnr][/snr]», f.eks. «3205-81/140».

forespørsel

curl https://api.spireapi.com/v1/eiendommer/3205-81%2F140 \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "matrikkel": "3205-81/140",
  "kommune": { "nr": "3205", "navn": "Lillestrøm" },
  "gnr": 81, "bnr": 140,
  "areal_m2": 812,
  "bygninger": [ { "bygningsnr": "180123456", "type": "Forretningsbygg", "bra_m2": 1240, "byggeaar": 1964 } ],
  "adresser": [ "adr_2000_storgata_5" ]
}

Fant du en feil? Si fra, så retter vi innen en virkedag.