Datakatalog

Datakatalogen inneholder metadata og definisjoner for alle vegobjekttyper, deres egenskaper, relasjoner og strukturer. API-et gir tilgang til å hente vegobjekttyper med tilhørende metadata fra datakatalogen.

Hent aktiv versjon

Returnerer aktiv versjon på datakatalogen.

Mønster

GET /datakatalog/api/v1/versjon

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/versjon

{
  "id": 1,
  "dato": "2025-01-15",
  "versjon": "2.31"
}

Hent alle vegobjekttyper

Returnerer alle vegobjekttypene med mulighet for å filtrere og inkludere tilleggsinformasjon.

Mønster

GET /datakatalog/api/v1/vegobjekttyper

Parametere

Parameter	Type	Beskrivelse
inkluder	array	Kommaseparert liste med informasjonsfelter som skal inkluderes i tillegg til metadata. Gyldige verdier: egenskapstyper, relasjonstyper, stedfesting, alle, minimum
kategori	integer	Begrens vegobjekttyper etter kategori ID

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/vegobjekttyper/45?inkluder=minimum

[
  {
    "id": 538,
    "navn": "Adresse",
    "kortnavn": "gate",
    "beskrivelse": "Sammensatt identifikator for veglenkeadresse. Merknad: Komplett vegadresse består i tillegg av husnummer og bokstav.",
    "veiledning": "",
    "sosinavn": "Veglenkeadresse",
    "sosinvdbnavn": "Adresse_538",
    "sorteringsnummer": 0,
    "status": "NVDB, ok",
    "hovedkategori": "Kategori 21",
    "tidsrom_relevant": true,
    "konnekteringslenke_ok": true,
    "abstrakt_type": false,
    "avledet": false,
    "må_ha_mor": false,
    "er_dataserie": false,
    "en_versjon": false,
    "kategorier": [
      {
        "id": 43,
        "primærkategori": true,
        "nummer": 20,
        "navn": "Vegnett - klassifisering",
        "sorteringsnummer": 14,
        "beskrivelse": "Inneholder vegobjekttyper som har med vegreferansesystemet å gjøre",
        "startDato": "2012-05-22"
      },
      {
        "id": 221,
        "primærkategori": false,
        "nummer": 2,
        "navn": "Vegnett basis - Områder",
        "sorteringsnummer": 12
      },
      {
        "id": 38,
        "primærkategori": false,
        "nummer": 282,
        "navn": "Alle",
        "kortnavn": "alle",
        "sorteringsnummer": 10,
        "beskrivelse": "Inneholder alle vegobjekttyper",
        "startDato": "2012-05-22"
      }
    ],
    "sensitiv": false
  }
]

Hent spesifikk vegobjekttype

Returnerer en angitt vegobjekttype med detaljert informasjon.

Mønster

GET /datakatalog/api/v1/vegobjekttyper/{vegobjekttypeid}

Parametere

Parameter	Type	Beskrivelse
vegobjekttypeid	integer	ID til vegobjekttypen (path parameter)
inkluder	array	Kommaseparert liste med informasjonsfelter som skal inkluderes

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/vegobjekttyper/45?inkluder=alle

{
  "id": 538,
  "navn": "Adresse",
  "kortnavn": "gate",
  "beskrivelse": "Sammensatt identifikator for veglenkeadresse. Merknad: Komplett vegadresse består i tillegg av husnummer og bokstav.",
  "veiledning": "",
  "stedfesting": {
    "id": 120538,
    "navn": "Liste av lokasjonsattributt",
    "kortnavn": "LST",
    "sorteringsnummer": 0,
    "obligatorisk_verdi": false,
    "skrivebeskyttet": false,
    "avledet": false,
    "sensitivitet": 0,
    "gruppesorteringsnummer": 0,
    "høydereferanse_tall": 0,
    "nøyaktighetskrav_grunnriss": 0,
    "nøyaktighetskrav_høyde": 0,
    "referansegeometri_tilstrekkelig": false,
    "viktighet": "IKKE_SATT",
    "kategori": 1000,
    "maksimalt_antall_verdier": 10000,
    "minimalt_antall_verdier": 0,
    "innhold": {
      "id": 100538,
      "navn": "StrekningTilknytning",
      "kortnavn": "ST",
      "sorteringsnummer": 0,
      "obligatorisk_verdi": false,
      "skrivebeskyttet": false,
      "avledet": false,
      "sensitivitet": 0,
      "gruppesorteringsnummer": 0,
      "høydereferanse_tall": 0,
      "nøyaktighetskrav_grunnriss": 0,
      "nøyaktighetskrav_høyde": 0,
      "referansegeometri_tilstrekkelig": false,
      "viktighet": "IKKE_SATT",
      "kategori": 1000,
      "stedfestingstype": "Linje",
      "geometritype": "LINJE",
      "overlapp_ok": false,
      "kjørefelt_relevant": "NEI",
      "sideposisjon_relevant": "NEI",
      "innenfor_mor": false,
      "vegnettsajourhold_splitt": "KAN_SPLITTES",
      "overlappsautomatikk": "x",
      "retning_relevant": false,
      "egenskapstype": "Stedfesting"
    },
    "egenskapstype": "Liste"
  },
  "sosinavn": "Veglenkeadresse",
  "sosinvdbnavn": "Adresse_538",
  "sorteringsnummer": 0,
  "status": "NVDB, ok",
  "hovedkategori": "Kategori 21",
  "tidsrom_relevant": true,
  "konnekteringslenke_ok": true,
  "abstrakt_type": false,
  "avledet": false,
  "må_ha_mor": false,
  "er_dataserie": false,
  "en_versjon": false,
  "kategorier": [
    {
      "id": 43,
      "primærkategori": true,
      "nummer": 20,
      "navn": "Vegnett - klassifisering",
      "sorteringsnummer": 14,
      "beskrivelse": "Inneholder vegobjekttyper som har med vegreferansesystemet å gjøre",
      "startDato": "2012-05-22"
    },
    {
      "id": 221,
      "primærkategori": false,
      "nummer": 2,
      "navn": "Vegnett basis - Områder",
      "sorteringsnummer": 12
    },
    {
      "id": 38,
      "primærkategori": false,
      "nummer": 282,
      "navn": "Alle",
      "kortnavn": "alle",
      "sorteringsnummer": 10,
      "beskrivelse": "Inneholder alle vegobjekttyper",
      "startDato": "2012-05-22"
    }
  ],
  "egenskapstyper": [
    {
      "id": 4588,
      "navn": "Adressekode",
      "beskrivelse": "Nummer som entydig identifiserer adresserbare veglenker i matrikkelen. For hvert adressenavn skal det således foreligge en adressekode, jf. matrikkelforskriften § 51.2. Merknad: Adressekode er unik innenfor kommunen.",
      "kortnavn": "adrsKode",
      "sorteringsnummer": 1,
      "obligatorisk_verdi": true,
      "skrivebeskyttet": false,
      "avledet": false,
      "sensitivitet": 0,
      "gruppesorteringsnummer": 0,
      "sosinavn": "adressekode",
      "sosinvdbnavn": "Adressekode_4588",
      "høydereferanse_tall": 0,
      "nøyaktighetskrav_grunnriss": 0,
      "nøyaktighetskrav_høyde": 0,
      "referansegeometri_tilstrekkelig": false,
      "lengdeavhengig_verdi": false,
      "ajourhold_snu": false,
      "viktighet": "PÅKREVD_ABSOLUTT",
      "kategori": 21,
      "min_anbefalt": 1,
      "maks_anbefalt": 99999,
      "feltlengde": 5,
      "fortegnsendring_snu": false,
      "egenskapstype": "Heltall"
    },
    {
      "id": 4589,
      "navn": "Adressenavn",
      "beskrivelse": "Navn på veglenke i matrikkelen (matrikkelforskriften § 2e).",
      "kortnavn": "adrsNavn",
      "sorteringsnummer": 2,
      "obligatorisk_verdi": true,
      "skrivebeskyttet": false,
      "avledet": false,
      "sensitivitet": 0,
      "gruppesorteringsnummer": 0,
      "sosinavn": "adressenavn",
      "sosinvdbnavn": "Adressenavn_4589",
      "høydereferanse_tall": 0,
      "nøyaktighetskrav_grunnriss": 0,
      "nøyaktighetskrav_høyde": 0,
      "referansegeometri_tilstrekkelig": false,
      "lengdeavhengig_verdi": false,
      "ajourhold_snu": false,
      "viktighet": "PÅKREVD_ABSOLUTT",
      "kategori": 21,
      "feltlengde": 50,
      "egenskapstype": "Tekst"
    },
    {
      "id": 9793,
      "navn": "Sideveg",
      "beskrivelse": "Angir om en veglenke er sideveg og dermed bruker adresser fra lenken den er sideveg fra. Dersom ikke oppgitt, gir det \"Nei\"- alternativet, dvs. \"Ikke sideveg\".",
      "kortnavn": "sideveg",
      "sorteringsnummer": 3,
      "obligatorisk_verdi": false,
      "skrivebeskyttet": false,
      "avledet": false,
      "sensitivitet": 0,
      "gruppesorteringsnummer": 0,
      "sosinavn": "sideveg",
      "veiledning": "Påkrevd hvis Ja.",
      "sosinvdbnavn": "Sideveg_9793",
      "høydereferanse_tall": 0,
      "nøyaktighetskrav_grunnriss": 0,
      "nøyaktighetskrav_høyde": 0,
      "referansegeometri_tilstrekkelig": false,
      "lengdeavhengig_verdi": false,
      "ajourhold_snu": false,
      "viktighet": "BETINGET",
      "kategori": 21,
      "feltlengde": 3,
      "tillatte_verdier": [
        {
          "id": 15943,
          "kortnavn": "J",
          "kortnavnlengde": 0,
          "kortnavn_brukbar": false,
          "sorteringsnummer": 1,
          "standardverdi": false,
          "verdi": "Ja",
          "type": "Tekst"
        },
        {
          "id": 15944,
          "kortnavn": "N",
          "kortnavnlengde": 0,
          "kortnavn_brukbar": false,
          "sorteringsnummer": 2,
          "standardverdi": false,
          "verdi": "Nei",
          "type": "Tekst"
        }
      ],
      "egenskapstype": "Tekstenum"
    },
    {
      "id": 12622,
      "navn": "Kommune",
      "beskrivelse": "Kommunenummer, fire siffer.",
      "kortnavn": "kommune",
      "sorteringsnummer": 4,
      "obligatorisk_verdi": true,
      "skrivebeskyttet": false,
      "avledet": false,
      "sensitivitet": 0,
      "gruppesorteringsnummer": 0,
      "sosinavn": "kommune",
      "sosinvdbnavn": "Kommune_12622",
      "høydereferanse_tall": 0,
      "nøyaktighetskrav_grunnriss": 0,
      "nøyaktighetskrav_høyde": 0,
      "referansegeometri_tilstrekkelig": false,
      "lengdeavhengig_verdi": false,
      "ajourhold_snu": false,
      "viktighet": "PÅKREVD_ABSOLUTT",
      "kategori": 21,
      "feltlengde": 4,
      "feltmønster": "xxxx",
      "egenskapstype": "Tekst"
    },
    {
      "id": 5037,
      "navn": "Geometri, hjelpelinje",
      "beskrivelse": "Linje/kurve er manus for å etablere vegobjektets stedfesting på vegnettet.",
      "kortnavn": "GeoHlpLi",
      "sorteringsnummer": 942,
      "obligatorisk_verdi": false,
      "skrivebeskyttet": false,
      "avledet": false,
      "sensitivitet": 0,
      "gruppesorteringsnummer": 0,
      "sosinavn": "senterlinje",
      "veiledning": "Geometrien benyttes kun i forbindelse med etablering av vegobjektet og skal normalt ikke lagres i NVDB.",
      "sosinvdbnavn": "GeometriHjelpelinje_5037",
      "grunnrissreferanse": "Vegens senterline eller parallell linje til denne",
      "høydereferanse": "Høyde avledes fra vegnettsgeometri, dermed ikke krav om høyde",
      "høydereferanse_tall": 0,
      "nøyaktighetskrav_grunnriss": 1,
      "nøyaktighetskrav_høyde": 0,
      "referansegeometri_tilstrekkelig": true,
      "viktighet": "OPSJONELL",
      "kategori": 21,
      "dimensjoner": 3,
      "geometritype": "LINJE",
      "innenfor_mor": false,
      "egenskapstype": "Geometri"
    }
  ],
  "relasjonstyper": {
    "foreldre": [],
    "barn": []
  },
  "sensitiv": false
}

Hent egenskapstype

Returnerer en angitt egenskapstype med all metadata.

Mønster

GET /datakatalog/api/v1/egenskapstyper/{egenskapstypeid}

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/egenskapstyper/4795

Hent egenskapstype for vegobjekttype

Returnerer en angitt egenskapstype for en spesifikk vegobjekttype.

Mønster

GET /datakatalog/api/v1/vegobjekttyper/{vegobjekttypeid}/{egenskapstypeid}

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/vegobjekttyper/45/4795

  {
  "id": 4795,
  "navn": "Geometri, punkt",
  "beskrivelse": "Gir punkt som geometrisk representerer objektet.",
  "kortnavn": "GeoPunkt",
  "sorteringsnummer": 941,
  "obligatorisk_verdi": false,
  "skrivebeskyttet": false,
  "avledet": false,
  "sensitivitet": 0,
  "gruppesorteringsnummer": 0,
  "sosinavn": "geometri_Punkt",
  "veiledning": "Skal ha samme geometri som morobjekt (Skiltpunkt).",
  "sosinvdbnavn": "GeometriPunkt_4795",
  "grunnrissreferanse": "Senter skiltpunkt.",
  "høydereferanse": "Topp skiltpunktfundament evt. overgang stolpe/terreng.",
  "høydereferanse_tall": 4,
  "nøyaktighetskrav_grunnriss": 1,
  "nøyaktighetskrav_høyde": 1,
  "sosi_referanse": "7601",
  "referansegeometri_tilstrekkelig": false,
  "viktighet": "PÅKREVD_IKKE_ABSOLUTT",
  "kategori": 22,
  "dimensjoner": 3,
  "geometritype": "PUNKT",
  "innenfor_mor": false,
  "egenskapstype": "Geometri"
}

Hent produktspesifikasjon

Returnerer produktspesifikasjonen til den angitte vegobjekttypen med registreringskrav og eksempler.

Mønster

GET /datakatalog/api/v1/vegobjekttyper/{vegobjekttypeid}/produktspesifikasjon

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/vegobjekttyper/45/produktspesifikasjon

{
  "url": "https://datakatalogen.atlas.vegvesen.no/45",
  "registrationConstraints": [
    {
      "title": "Registreringskrav",
      "content": ["Må ha minst en egenskap", "Stedfesting er påkrevd"]
    }
  ],
  "examples": [
    {
      "title": "Eksempel 1",
      "url": "https://example.com/eksempel1"
    }
  ]
}

Hent historiske vegobjekttyper

Returnerer alle vegobjekttypene for en gitt versjon av datakatalogen.

Mønster

GET /datakatalog/api/v1/vegobjekttyper/historisk/{versjon}

Parametere

Parameter	Type	Beskrivelse
versjon	string	Versjonsnummer (f.eks. "2.31")
inkluder	array	Informasjonsfelter som skal inkluderes
kategori	integer	Filtrer etter kategori ID

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/vegobjekttyper/historisk/2.31?inkluder=egenskapstyper

Hent kategorier

Returnerer alle kategorier for vegobjekter.

Mønster

GET /datakatalog/api/v1/kategorier

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/kategorier

[
  {
    "id": 1,
    "navn": "Veg",
    "kortnavn": "Veg",
    "sorteringsnummer": 1,
    "beskrivelse": "Vegobjekter knyttet til vegen",
    "startDato": "2000-01-01"
  }
]

Hent egenskapstypekategorier

Returnerer alle kategorier for egenskapstypene.

Mønster

GET /datakatalog/api/v1/egenskapstypekategorier

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/egenskapstypekategorier

Hent enheter

Returnerer alle måleenheter som brukes i egenskapstyper.

Mønster

GET /datakatalog/api/v1/enheter

Eksempel

https://nvdbapiles.atlas.vegvesen.no/datakatalog/api/v1/enheter

[
  {
    "id": 1,
    "navn": "Meter",
    "kortnavn": "m"
  },
  {
    "id": 2,
    "navn": "Kilometer",
    "kortnavn": "km"
  }
]