Gå til hovedinnhold

Vegobjekter

SRID

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/1",
  "metadata": {
    "type": {
      "id": 96,
      "navn": "Skiltplate"
    },
    "versjon": 1,
    "startdato": "2005-07-25",
    "sist_modifisert": "2023-06-18T17:11:34"
  },
  "geometri": {
    "wkt": "POINT (269101.622 7035280.985)",
    "srid": 5973,
    "egengeometri": true
  },
  "geometrimål": {
    "egengeometri": true
  },
  "lokasjon": {
    "kommuner": [
      5001
    ],
    "fylker": [
      50
    ],
    "kontraktsområder": [
      {
        "id": 830632989,
        "navn": "1631 Klett - Kroppan bru 2016-2020"
      },
      {
        "id": 920258479,
        "navn": "Driftskontrakt riksveg Trøndelag sør 2020-2025"
      },
      {
        "id": 920259277,
        "nummer": 9401,
        "navn": "9401 Trondheim 2020-2025 (t.o.m. 31.08.2023)"
      },
      {
        "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": 1014967665,
        "navn": "Rekkverkskontrakt midt 2021-2022"
      }
    ],
    "riksvegruter": [
      {
        "id": 1017625546,
        "nummer": "6A",
        "navn": "RUTE6A",
        "periode": "2014-2023 / 2018-2029"
      }
    ],
    "gater": [
      {
        "navn": "Europaveg 6",
        "gatekode": 1666
      }
    ],
    "vegsystemreferanser": [
      {
        "vegsystem": {
          "id": 1002318233,
          "versjon": 1,
          "vegkategori": "E",
          "fase": "V",
          "nummer": 6
        },
        "strekning": {
          "id": -1,
          "versjon": -1,
          "strekning": 75,
          "delstrekning": 1,
          "arm": false,
          "adskilte_løp": "Nei",
          "trafikantgruppe": "K",
          "retning": "MED",
          "meter": 191.72
        },
        "kortform": "EV6 S75D1 m192"
      }
    ],
    "stedfestinger": [
      {
        "type": "Punkt",
        "veglenkesekvensid": 72810,
        "relativPosisjon": 0.77755961,
        "retning": "MED",
        "kjørefelt": [],
        "kortform": "0.77755961@72810",
        "sideposisjon": "H"
      }
    ],
    "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.

Optimalisering

Det er gjort en del optimaliseringer på dette endepunktet. Dersom du ønsker å hente ut alle vegobjektene og ikke bryr deg om rekkefølgen så kan du benytte deg av ?sortering=false parameteren. Dette vil gi deg en betydelig raskere respons. Det samme gjelder for totalt antall vegobjekter som er tilgjengelig under den angitte begrensningen. Dersom du ikke bryr deg om å få et eksakt tall så kan du benytte deg av ?inkluderAntall=false parameteren. Dersom du ønsker å få et eksakt tall så kan du benytte deg av ?inkluderAntall=true parameteren.

Eksempelvis så er både rekkefølge og totalt antall irrelevant for visning av vegobjekter på et kart.

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/1",
      "metadata": {
        "type": {
          "id": 10,
          "navn": "Nedsenka kantstein"
        },
        "versjon": 1,
        "startdato": "2006-02-15",
        "sist_modifisert": "2023-12-04T12:09:50"
      }
    },
    {
      "id": 80591296,
      "href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10/80591296/1",
      "metadata": {
        "type": {
          "id": 10,
          "navn": "Nedsenka kantstein"
        },
        "versjon": 1,
        "startdato": "2006-02-15",
        "sist_modifisert": "2023-12-04T12:09:50"
      }
    },
    {
      "id": 80591326,
      "href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10/80591326/1",
      "metadata": {
        "type": {
          "id": 10,
          "navn": "Nedsenka kantstein"
        },
        "versjon": 1,
        "startdato": "2006-02-15",
        "sist_modifisert": "2023-12-04T12:09:50"
      }
    }
  ],
  "metadata": {
    "returnert": 3,
    "sidestørrelse": 3,
    "neste": {
      "start": "3",
      "href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/10?inkluder=metadata&start=3&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-v3.atlas.vegvesen.no/vegobjekter/105/137046214/1",
    "metadata": {
      "type": {
        "id": 105,
        "navn": "Fartsgrense"
      },
      "versjon": 1,
      "startdato": "2007-07-09",
      "sluttdato": "2009-01-16",
      "sist_modifisert": "2009-02-18T12:38:46"
    }
  },
  {
    "id": 137046214,
    "href": "https://nvdbapiles-v3.atlas.vegvesen.no/vegobjekter/105/137046214/2",
    "metadata": {
      "type": {
        "id": 105,
        "navn": "Fartsgrense"
      },
      "versjon": 2,
      "startdato": "2009-01-16",
      "sluttdato": "2014-10-20",
      "sist_modifisert": "2023-02-28T13:34:25"
    }
  },
  {
    "id": 137046214,
    "href": "https://nvdbapiles-v3.atlas.vegvesen.no/vegobjekter/105/137046214/4",
    "metadata": {
      "type": {
        "id": 105,
        "navn": "Fartsgrense"
      },
      "versjon": 4,
      "startdato": "2014-10-20",
      "sist_modifisert": "2023-06-18T17:11:34"
    }
  }
]