Skip to main content

Endringer

Antall for endringer

Sidestørrelsen vil være veiledende i forhold til hva som blir returnert i responsen. antall parameteret vil bestemme sidestørrelsen men det returnerte antallet trenger ikke å være lik sidestørrelsen ettersom endringene som returneres vil være aggregert dersom det finnes flere hendelser på samme id innenfor tidsrom og antall restriksjoner. Da vil man kunne få et returnert antall som er mindre enn det som er spesifisert i sidestørrelse eller antall parameteret.

Hent endringer for vegobjekter siden gitt tidspunkt​

Henter alle vegobjektsendringer som har blitt prosessert og gjort tilgjengelig i Les API V4 etter gitt tidspunkt.

Responsen vil inneholde fire lister med endringer, en per endringstype.

Per i dag publiseres følgende endringstyper for vegobjekter:

  • VegobjektVersjonOpprettet: Et vegobjekt har fått en ny versjon. Med versjon = 1, så skal det være et helt nytt objekt. Med versjon <> 1, så er det en ny versjon av et eksisterende objekt.
  • VegobjektVersjonEndret: En vegobjektversjon har blitt oppdatert (oppdatering av egenskaper, stedfesting, relasjoner, gyldighetsperiode, etc.).
  • VegobjektVersjonFjernet: En vegobjektversjon har blitt slettet. Med versjon = 1, er vegobjektet fullstendig borte.
  • VegobjektVersjonSegmentert: Det underliggende vegnettet har blitt resegmentert og ført til nye vegsegmenter på vegobjektversjon.

I utgangspunktet vil man få endringer for alle vegobjekter innenfor spesifisert vegobjekttype, men det er mulig å spesifisere en liste med vegobjekt ID-er som man er interessert i.

Mønster​

GET /api/v4/vegobjekter/{vegobjekttypeId}/endringer

Eksempel​

https://nvdbapiles.atlas.vegvesen.no/vegobjekter/api/v4/vegobjekter/904/endringer?ider=834243318&ider=834244538&ider=980495583&start=2025-05-01
{
  "vegobjektVersjonerEndret": [
    {
      "id": 834243318,
      "versjon": 1,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:32.909542Z",
      "startdato": "1980-01-01",
      "sluttdato": "2015-08-27"
    },
    {
      "id": 834243318,
      "versjon": 2,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:32.909542Z",
      "startdato": "2015-08-27"
    },
    {
      "id": 834244538,
      "versjon": 1,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:38.904016Z",
      "startdato": "2003-10-15",
      "sluttdato": "2009-10-26"
    },
    {
      "id": 834244538,
      "versjon": 2,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:38.904016Z",
      "startdato": "2009-10-26",
      "sluttdato": "2013-06-19"
    },
    {
      "id": 834244538,
      "versjon": 3,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:38.904016Z",
      "startdato": "2013-06-19",
      "sluttdato": "2015-08-21"
    },
    {
      "id": 834244538,
      "versjon": 4,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:38.904016Z",
      "startdato": "2015-08-21",
      "sluttdato": "2017-02-16"
    },
    {
      "id": 834244538,
      "versjon": 5,
      "type": 904,
      "tidspunkt": "2025-05-05T00:45:38.904017Z",
      "startdato": "2017-02-16"
    }
  ],
  "vegobjektVersjonerFjernet": [
    {
      "id": 980495583,
      "versjon": 1,
      "type": 904,
      "tidspunkt": "2025-05-05T00:52:18.719687Z"
    },
    {
      "id": 980495583,
      "versjon": 2,
      "type": 904,
      "tidspunkt": "2025-05-05T00:52:18.719687Z"
    },
    {
      "id": 980495583,
      "versjon": 3,
      "type": 904,
      "tidspunkt": "2025-05-05T00:52:18.719687Z"
    }
  ],
  "vegobjektVersjonerSegmentert": [],
  "vegobjektVersjonerOpprettet": [],
  "metadata": {
    "returnert": 10,
    "sidestørrelse": 1000,
    "neste": {
      "start": "2025-05-05T00:52:18.719687Z,980495583,3",
      "href": "https://nvdbapiles.atlas.vegvesen.no/vegobjekter/api/v4/vegobjekter/904/endringer?ider=834243318&ider=834244538&ider=980495583&start=2025-05-05T00:52:18.719687Z,980495583,3&antall=1000"
    }
  }
}

Hent endringer for veglenkesekvenser siden gitt tidspunkt​

Henter alle endringer på veglenkesekvenser som har blitt prosessert og gjort tilgjengelig i Les API V4 etter gitt tidspunkt.

Responsen vil inneholde to lister med veglenkesekvenser, en for veglenkesekvenser som har blitt segmentert og en for hvilke veglenkesekvenser som har blitt slettet. De fleste hendelser på veglenkesekvenser vil være segmenteringshendelser, ettersom dette skjer hver gang det endres på et objekt som påvirker segmenteringen av veglenkesekvensen, inkludert når veglenkesekvensen segmenteres første gang.

info

Dette endepunktet publiserer kun endringer som skjer på det segmenterte vegnettet, og vil derfor ikke publisere endringer på f.eks. noder. Dersom du ønsker å følge med på endringer på det usegmenterte vegnettet, må du bruke hendelsesendepunktene i det uberikede API-et

Mønster​

GET /api/v4/veglenkesekvenser/endringer

Eksempel​

https://nvdbapiles.atlas.vegvesen.no/vegnett/api/v4/veglenkesekvenser/endringer?start=2025-07-22&antall=50
{
  "veglenkesekvenserFjernet": [],
  "veglenkesekvenserSegmentert": [
    { "id": 4002204, "tidspunkt": "2025-07-22T06:36:51.024076Z" },
    { "id": 4002203, "tidspunkt": "2025-07-22T06:36:51.024685Z" },
    { "id": 3929881, "tidspunkt": "2025-07-22T06:36:51.118434Z" },
    { "id": 3130637, "tidspunkt": "2025-07-22T06:36:58.741232Z" },
    { "id": 2689488, "tidspunkt": "2025-07-22T06:36:58.811404Z" },
    { "id": 3407586, "tidspunkt": "2025-07-22T06:36:59.033385Z" }
  ],
  "metadata": {
    "returnert": 6,
    "sidestørrelse": 50,
    "neste": {
      "start": "2025-07-22T06:36:59.033385Z,3407586",
      "href": "https://nvdbapiles.atlas.vegvesen.no/vegnett/api/v4/veglenkesekvenser/endringer?start=2025-07-22T06:36:59.033385Z,3407586&antall=50"
    }
  }
}