Vegobjekter
Angir hvilket geografisk referansesystem geometrien skal returneres i. Utdata i UTM-formater begrenses til 3 desimaler, 4326/WGS84 begrenses til 8 desimaler.
Hent vegobjekt
Henter et vegobjekt med gitt ID. Dette endepunktet vil som standard returere siste versjonen av vegobjektet. Skulle det være ønskelig å sjekke en tidligere versjon så kan dette gjøres ved å spesifisere tidspunkt i URLen.
Avhengig av bruksformål så er det mulig å spesifisere hvilke data som skal returneres. Dette gjøres ved å spesifisere inkluder parameteren i URLen. Dette er en kommaseparert liste med verdier som er definert i Open-API NVDB API Les V4 - Vegobjekt. Dersom ingenting er spesifisert så vil alle data returneres.
For fullstendig oversikt over alle parametere som kan benyttes så viser vi til Open-API NVDB API Les V4 - Vegobjekt.
Mønster
GET /api/v4/vegobjekt/{id}
eller
GET /api/v4/vegobjekter/{vegobjekttypeid}/{id}
eller
GET /api/v4/vegobjekter/{vegobjekttypeid}/{vegobjektId}/{versjon}
Eksempel
https://nvdbapiles.atlas.vegvesen.no/vegobjekter/api/v4/vegobjekt?id=85773305&inkluder=metadata&inkluder=lokasjon&inkluder=geometri
{
"id": 85773305,
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/96/85773305",
"metadata": {
"type": {
"id": 96,
"navn": "Skiltplate"
},
"versjon": 1,
"startdato": "2005-07-25",
"sist_modifisert": "2025-03-06T10:26:41Z"
},
"geometri": {
"wkt": "POINT Z (269101.622 7035280.985 -999999)",
"srid": 5973,
"egengeometri": true
},
"lokasjon": {
"kommuner": [
5001
],
"fylker": [
50
],
"kontraktsområder": [
{
"id": 1004758086,
"nummer": 9401,
"navn": "9401 Trondheim 2020-2025 (f.o.m. 01.09.2023)"
},
{
"id": 1007479425,
"nummer": 9451,
"navn": "9451 Elektrokontrakt Trøndelag 2022-2026"
},
{
"id": 1019226085,
"nummer": 9405,
"navn": "DK 9405 Trøndelag sør"
},
{
"id": 1019330755,
"nummer": 9481,
"navn": "9481 Rekkverk Trøndelag og Møre og Romsdal 2023-2024"
}
],
"riksvegruter": [
{
"enumid": 20296,
"riksvegrute": "Rute 6a: E6 Oslo - Trondheim"
}
],
"vegforvaltere": [
{
"enumid": 21771,
"vegforvalter": "Statens vegvesen"
}
],
"adresser": [
{
"navn": "Europaveg 6",
"adressekode": 1666
}
],
"vegsystemreferanser": [
{
"vegsystem": {
"vegkategori": "E",
"fase": "V",
"nummer": 6
},
"strekning": {
"strekning": 75,
"delstrekning": 1,
"arm": false,
"adskilte_løp": "Nei",
"trafikantgruppe": "K",
"retning": "MED",
"meter": 191.72
},
"metrertLokasjon": {
"retning": "MED",
"sideposisjon": "H"
},
"kortform": "EV6 S75D1 m192"
}
],
"stedfestinger": [
{
"type": "Punkt",
"veglenkesekvensid": 72810,
"relativPosisjon": 0.77755961,
"retning": "MED",
"kjørefelt": [],
"sideposisjon": "H",
"kortform": "0.77755961@72810"
}
],
"geometri": {
"wkt": "POINT Z (269091.091 7035280.378 133.776)",
"srid": 5973
}
}
}
Hent vegobjekter
Henter vegobjekter med gitt vegobjekttypeid. Dette endepunktet vil som standard returere siste versjonen av vegobjektet. Skulle det være ønskelig å sjekke en tidligere versjon så kan dette gjøres ved å spesifisere tidspunkt i URLen.
Avhengig av bruksformål så er det mulig å spesifisere hvilke data som skal returneres. Dette gjøres ved å spesifisere inkluder parameteren i URLen. Dette er en kommaseparert liste med verdier som er definert i Open-API NVDB API Les V4 - Vegobjekter. Dersom ingenting er spesifisert så vil minimum data returneres.
Det er mulig å begrense søket sitt på ulike parametere som f.eks kommune, fylke, vegsystemreferanse, kontraktsomrade, riksvegrute, kartutsnitt, polygon og mange flere. Dette gjøres ved å spesifisere de som parameteren i URLen. Fullstendig oversikt over alle begreningsmulighetene er definert i Open-API NVDB API Les V4 - Vegobjekter. Dersom ingenting er spesifisert så vil vegobjekter fra hele landet returneres.
For fullstendig oversikt over alle parametere som kan benyttes så viser vi til Open-API NVDB API Les V4 - Vegobjekter.
For å optimalisere uthenting av vegobjekter har V4 innført et inkluderAntall-parameter. Dersom du ikke bryr deg om det totale antallet innenfor det gitte filteret (dette er eksempelvis irrelevant for kartapplikasjoner) settes denne til false.
Standardverdien for parameteret er false.
Mønster
GET /api/v4/vegobjekter/{vegobjekttypeid}
Eksempel
https://nvdbapiles.atlas.vegvesen.no/vegobjekter/api/v4/vegobjekter/10?inkluder=metadata&antall=3
{
"objekter": [
{
"id": 80591277,
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10/80591277",
"metadata": {
"type": {
"id": 10,
"navn": "Nedsenka kantstein"
},
"versjon": 1,
"startdato": "2006-02-15",
"sist_modifisert": "2025-03-06T09:17:00Z"
}
},
{
"id": 80591296,
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10/80591296",
"metadata": {
"type": {
"id": 10,
"navn": "Nedsenka kantstein"
},
"versjon": 1,
"startdato": "2006-02-15",
"sist_modifisert": "2025-03-06T09:17:00Z"
}
},
{
"id": 80591326,
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10/80591326",
"metadata": {
"type": {
"id": 10,
"navn": "Nedsenka kantstein"
},
"versjon": 1,
"startdato": "2006-02-15",
"sist_modifisert": "2025-03-06T09:17:00Z"
}
}
],
"metadata": {
"returnert": 3,
"sidestørrelse": 3,
"neste": {
"start": "80591326:1",
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10?inkluder=metadata&start=80591326:1&antall=3"
}
}
}
Hent alle versjoner av vegobjekt
Henter alle versjonene for et vegobjekt med gitt ID. Dette endepunktet vil som standard returere alle versjonen av vegobjektet. Skulle det være ønskelig å begrense til bare tidligere versjon innenfor et tidspunkt så kan dette gjøres ved å spesifisere tidspunkt i URLen.
Avhengig av bruksformål så er det mulig å spesifisere hvilke data som skal returneres. Dette gjøres ved å spesifisere inkluder parameteren i URLen. Dette er en kommaseparert liste med verdier som er definert i Open-API spesifikasjonen. Dersom ingenting er spesifisert så vil alle data returneres.
For fullstendig oversikt over alle parametere som kan benyttes så viser vi til Open-API NVDB API Les V4 - Vegobjekt.
Mønster
GET /api/v4/vegobjekter/{vegobjekttypeid}/{vegobjektId}/versjoner
Eksempel
https://nvdbapiles.atlas.vegvesen.no/vegobjekter/105/137046214/versjoner?inkluder=metadata
[
{
"id": 137046214,
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/105/137046214/1",
"metadata": {
"type": {
"id": 105,
"navn": "Fartsgrense"
},
"versjon": 1,
"startdato": "2009-01-16",
"sluttdato": "2014-10-20",
"sist_modifisert": "2025-03-06T10:23:56Z"
}
},
{
"id": 137046214,
"href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/105/137046214",
"metadata": {
"type": {
"id": 105,
"navn": "Fartsgrense"
},
"versjon": 2,
"startdato": "2014-10-20",
"sist_modifisert": "2025-03-06T10:23:56Z"
}
}
]