Kilda
Logg inn
Location API Tilgjengelig i alle pakker

Norske adresser og postnummer, ferdig normalisert.

Location API er fundamentet i Kilda. Slå opp, søk i og verifiser adresser, postnummer, kommuner og fylker gjennom ett stabilt grensesnitt – med koordinater og geometri der du trenger dem.

Kom i gang gratis Se endepunktene
Adressesøk – forespørsel 
curl "https://kilda.no/v1/addresses?q=storgata+10" \
  -H "Authorization: Bearer kld_live_..."
Svar 
{
  "data": [
    {
      "id": "84947446",
      "address_text": "Storgata 10",
      "street": "Storgata",
      "number": 10,
      "postal_code": "0155",
      "postal_city": "OSLO",
      "municipality": {
        "number": "0301",
        "name": "Oslo"
      },
      "latitude": 59.9138,
      "longitude": 10.7522
    }
  ],
  "meta": { "total": 1, "page": 1 }
}
Postnummeroppslag – forespørsel 
curl "https://kilda.no/v1/postal-codes/5003" \
  -H "Authorization: Bearer kld_live_..."
Svar 
{
  "data": {
    "postal_code": "5003",
    "city": "BERGEN",
    "type": "STREET_ADDRESSES",
    "status": "active",
    "municipality": {
      "number": "4601",
      "name": "Bergen"
    },
    "county": {
      "number": "46",
      "name": "Vestland"
    },
    "country": "NO",
    "latitude": 60.3925,
    "longitude": 5.3242
  }
}

0

adresser

0

postnummer

0

kommuner

0

fylker

Geografisk identitet, ikke bare et oppslag

Målet er ikke å returnere en rad fra et register, men å gi deg en pålitelig geografisk identitet du kan bygge resten av systemet ditt på.

Hele Norge, ikke et utvalg

Samtlige offisielle adresser og postnummer, inkludert matrikkeladresser uten gatenavn. Kommuner og fylker følger gjeldende inndeling.

Normalisert ved import

Store og små bokstaver, æ ø å, samiske stedsnavn og alternative skrivemåter foldes til én søkbar form når dataene lastes inn – ikke ved hvert kall.

Koordinater og geometri

Hver adresse har lengde- og breddegrad, og hvert postnummerområde har en flate som GeoJSON. Ingen ekstra tjeneste å integrere for kartet.

Verifisering uten feilhåndtering

Verify-endepunktene svarer ja eller nei med status 200. «Finnes ikke» er et svar, ikke et unntak du må fange i frontenden.

Bygget for autocomplete

Indekserte oppslag og aggressiv caching gir svar raskt nok til å spørre mens brukeren skriver, uten at du må bygge et mellomlager selv.

Samme kontrakt som resten

Feltnavn, paginering, feilformat og statuskoder er de samme som i alle andre Kilda-produkter. Du lærer det én gang.

Endepunktene i Location API

Alle er GET, alle autentiseres med den samme API-nøkkelen, og alle returnerer det samme JSON-formatet. Ingen SDK er påkrevd.

  • GET /v1/postal-codes

    Postnummerliste

    Hele postnummerregisteret, paginert, med filtre på poststed, kommune og fylke. Til nedtrekkslister og til å speile registeret hos deg selv.

  • GET /v1/postal-codes/{postnummer}

    Postnummeroppslag

    Poststed, kommune og fylke for ett postnummer, med nummer og navn på begge nivåer.

  • GET /v1/postal-codes/{postnummer}/verify

    Verifiser postnummer

    Finnes postnummeret? Svaret er alltid 200 med «valid», så et skjema som spør på hvert tastetrykk slipper å behandle nei som en feil.

  • GET /v1/postal-codes/{postnummer}/geometry

    Postnummergeometri

    Postnummerområdet som GeoJSON etter RFC 7946 – klart til å legges rett i et kart uten omskriving.

  • GET /v1/postal-codes/{postnummer}/history

    Postnummerhistorikk

    Hele endringsloggen for ett postnummer, nyeste først – opprettet, opphørt, omnummerert, nytt poststedsnavn eller ny kommune, med tilstanden før og etter. Også endringene som gjorde et annet postnummer om til dette.

  • GET /v1/addresses

    Adressesøk

    Fritekstsøk der ordene kan komme i hvilken som helst rekkefølge, kombinert med filtre på postnummer, kommune, husnummer og adressetype. Paginert.

  • GET /v1/addresses/{id}

    Adresseoppslag

    Én adresse på den stabile ID-en søket deler ut – den samme ID-en overlever neste import.

  • GET /v1/addresses/verify

    Verifiser adresse

    Sjekk en adresse mot et postnummer, enten som fri tekst eller oppdelt i gate, nummer og bokstav.

  • GET /v1/addresses/nearby

    Nærmeste adresser

    Adressene innenfor en radius fra et punkt, nærmeste først, med avstand i meter på hvert treff.

  • GET /v1/counties

    Fylkesliste

    Alle fylkene i ett svar, sortert på navn. En referanseliste du henter én gang og cacher – ingen paginering å forholde seg til.

  • GET /v1/counties/{fylkesnummer}

    Fylkesoppslag

    Ett fylke på fylkesnummeret, med antall kommuner og representasjonspunkt.

  • GET /v1/counties/{fylkesnummer}/municipalities

    Kommunene i et fylke

    Kommunene fylket består av, sortert på navn. Fylket står i «meta» i stedet for å gjentas på hver rad.

  • GET /v1/counties/{fylkesnummer}/geometry

    Fylkesgeometri

    Fylkesgrensen som GeoJSON etter RFC 7946 – den faktiske omrisset fra Geonorge, ikke en omsluttende boks.

  • GET /v1/municipalities

    Kommuneliste

    Alle kommunene i ett svar, sortert på navn, eventuelt filtrert på navnefragment eller fylke.

  • GET /v1/municipalities/{kommunenummer}

    Kommuneoppslag

    Én kommune på kommunenummeret, med fylket den ligger i – slik du slår opp nummeret en adresse eller et postnummer oppgir.

  • GET /v1/municipalities/{kommunenummer}/geometry

    Kommunegeometri

    Kommunegrensen som GeoJSON etter RFC 7946, med kommune og fylke som egenskaper så et kart kan merke flaten uten et kall til.

Hvor dataene kommer fra

Dataene hentes fra åpne, offentlige norske registre. Vi viser alltid kildene – verdien ligger i at vi samler, kvalitetssikrer og oppdaterer informasjonen for deg.

Matrikkelen

Kartverket

  • Offisielle adresser med gate, nummer, bokstav og bruksnavn
  • Koordinater per adresse
  • Grunnkrets, valgkrets, sokn og tettsted
  • Matrikkelnummer og stabil adresse-ID

Administrative enheter

Kartverket / Geonorge

  • Kommune- og fylkesinndeling med gjeldende numre og navn
  • Omriss av kommuner og fylker
  • Flategeometri per postnummerområde

Postnummerregisteret

Bring / Posten

  • Postnummer og poststed
  • Type postnummer og status
  • Historikk over opprettede, endrede og nedlagte postnummer

Hele Location API, gratis

Grunndataene er offentlige, og verdien ligger i normaliseringen. Ingen felter og ingen endepunkter holdes tilbake – du får 1 000 kall i måneden uten kredittkort.

Opprett konto Les dokumentasjonen