Gå til hovedinnhold

Raskere tilgang til oppdaterte data i ny NVDB-kjerne (API-v4)

· 3 min lesetid

Den nye NVDB-kjernen sikrer raskere tilgang til oppdaterte vegdata. Endringer i kontraktsområder og riksvegruter blir nå vist fortløpende, i stedet for å måtte vente til hele endringsprosessen er ferdig. Dette gir deg mer oppdatert informasjon i sanntid.

Tekniske endringer:​

  • Les API-v4 er bygd som flere tjenester som kjører på flere servere samtidig.
  • Endringssett splittes opp i småjobber, som kjører parallelt.
  • Vegnettsendringer og endringer av vegobjekter prosesseres samtidig.
  • Data oppdateres fortløpende gjennom kontinuerlig segmentering og beriking av endrede vegobjekter.
  • Les API-v4 har mulighet for en horisontal skalering ved å øke antall servere for å håndtere større mengder data.

Hva betyr dette for deg?​

Ukentlig fullindeksering utgår​

  • Fullindeksering i Les API-v3 skjer i dag hver fredag og tar ca. 30 t.
  • I denne perioden blir ikke innsendte endringer tilgjengelige før indekseringen er ferdig kjørt.
  • Den nye arkitekturen i Les API-v4 eliminerer behovet for denne ukentlige fullindekseringen.

Statusoppdateringer endres​

  • I Les API-v4 behandles endringssett som mange småjobber i parallelle køer, så sporing av hele endringssett er ikke lenger hensiktsmessig.
  • Statusen «UTFØRT_OG_ETTERBEHANDLET» i Les API-v3, som indikerer når endringene i et endringssett er tilgjengelige, utgår.
  • /transaksjoner og /status i Les API-v3, som er tett knyttet mot oppdatering av endringssett, utgår.

Trenger du å vite når data ble oppdatert?​

Det vil bli mulig å hente en oversikt over nye, endrede og fjernede vegobjekter og vegnett i et bestemt tidsrom, tilsvarende /transaksjoner i v3, men med følgende forskjeller:

  • Endringer vil bestå av lister med ID-er og vil ikke inneholde tilknytning til endringssett.
  • I v3 kunne enkelte endringer være "usynlige", dvs. ikke vises som transaksjoner. I v4 vil alle endringer være synlige.

Nye endepunkt er under utvikling, og vil bli lansert i juni.

Risiko og anbefalinger​

Det er en risiko for at systemer og tredjepartsverktøy kan sitte med utdatert data, dersom de ikke tilpasser seg den nye måten å overvåke endringer på. For å sikre at redigering skjer med oppdaterte data, anbefales det å sjekke endringer før innsending.

Viktig: For systemer og tredjepartsverktøy som bruker eksisterende endepunkt og status anbefaler vi å avvente overgangen fra v3 til v4 til juni, når de nye endepunktene er klare.

Tidslinje og mer informasjon​

  • Ny kjerne kommer i produksjon i mai.
  • Nye endepunkter for å overvåke endringer lanseres i juni.
  • Se migreringssiden for full oversikt over forskjeller mellom v3 og v4.

Har du spørsmål? Kontakt oss via kontaktskjemaet eller send e-post til nvdb-api@vegvesen.no.