Gå til hovedinnhold
· 3 min lesetid

Oppdatert: Ny kjerne Les API-v4 blir lansert 8. mai 2025 kl. 08:00.​

merknad

Lanseringen var planlagt til mandag 5. mai, men ble utsatt grunnet behovet for en full innlasting like før produksjon. Den nye arkitekturen kan svare på spørringer mens en full innlasting pågår, men det kan være noe forsinkelse, så vi valgte å redusere risiko ved å heller utsette lanseringen noen dager.

Er du nysgjerrig kan du teste den nye arkitekturen i ATM-miljøet så lenge:

For å migrere fra NVDB Les API-v3 til v4, må du endre APIets URL:

Fra

https://nvdbapiles-v3.atlas.vegvesen.no 

Til

https://nvdbapiles.atlas.vegvesen.no 

På sistnevnte side vil du bli møtt av en hjelpsom forside, som vil inneholde nyttig informasjon for å bruke Les API-v4 på en effektiv måte. Viktige forskjeller mellom v3 og v4 er dokumentert på Forskjeller mellom V3 og V4.

Bruker du allerede v4?  ​

Les API-v4 har vært i produksjon i sin første versjon en stund, som «Les API-v4 med tilbakefall til v3». Dersom dere allerede har tatt dette i bruk, trenger dere ikke å endre URL, men det finnes likevel endringer dere også må ta hensyn til. Gå til Bruker du allerede V4? for å se alle kjente forskjeller mellom «v4 med tilbakefall til v3» og den versjonen som kommer nå, «v4 uten tilbakefall til v3».

Annen informasjon  ​

Endepunktet med postfiks -blue blir ikke lenger tilgjengelig: https://nvdbapiles.atlas.vegvesen.no/*tjeneste*-blue/api/v4 

Det som tidligere var på «-blue» blir tilgjengelig på: https://nvdbapiles.atlas.vegvesen.no/*tjeneste*/api/v4

Endepunktet Les API-v3 er fortsatt tilgjengelig, men har kodefrys: http://nvdbapiles-v3.atlas.vegvesen.no/

Se video for visualisering av kommende steg og videre plan etter sommerferien:

Veien videre ​

Fra 8. mai går vi inn en midlertidig periode hvor både Les API-v3 og Les API-v4 kjører parallelt. Dette sikrer en smidig overgang mellom de to systemene, og gjøre det mulig for systemer og tredjepartsverktøy å tilpasse seg den nye løsningen gradvis, uten brudd i eksisterende arbeidsflyter og integrasjoner. Denne fasen varer til august 2025.

Som tidligere annonsert i Raskere tilgang til oppdaterte data i ny NVDB-kjerne, lanseres /endringer-endepunktene i juni. De som er avhengige av statusoppdateringer kan da migrere til v4.

Fra august starter vi avviklingen av API Les-v3, så sørg for å sette av tid til migrering.

Oppsummering  ​

  • Ny kjerne i produksjon: 8. mai
  • Nye endepunkter for endringsovervåkning: juni
  • Utfasing av v3: fra august
  • Både migrasjon fra v3 eller «v4 med tilbakefall til v3» krever tilpasninger
  • For fullstendig oversikt over forskjeller, se Migrere fra V3 til V4.

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

· 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.

· 3 min lesetid

Med ny løsning og arkitektur åpner det seg muligheter for ny funksjonalitet. Her lanserer vi to som kommer i siste versjon av ny kjerne. De kan tas i bruk i produksjon fra mai, men er tilgjengelige i test allerede nå.

Vegforvalter​

Vi introduserer i Les API-v4 en ny mulighet for brukere og systemer til å hente ut vegdata filtrert på Vegforvalter.

Vegobjekttypen Vegforvalter (978) er lagt til som en segmenteringstype i Les API-v4. Det betyr at vegnett og vegobjekter berikes med informasjon om overlappende vegobjekter av denne typen, slik det allerede gjøres for Riksvegrute (704), Kontraktsomåde (580) og Adresse (538). Dermed kan Vegforvalter brukes som filtreringsparameter ved uthenting av vegnett eller vegobjekter.

Metreringsretning​

For å gjøre det enklere å orientere seg i den fysiske verden på vegen, introduserer vi i Les API V4 en ny mulighet for brukere og systemer til å hente ut vegobjekt med verdier justert etter metreringsretning. Metreringsretning angir hvilken retning en veg strekker seg fra start til slutt i NVDB, i forhold til retningen for vegens geometri. Dette settes på strekningsobjektene og brukes til å bestemme hvordan vegen og tilknyttede vegobjekter skal tolkes. 

I Les API-v3 kan vegobjekter vises på feil side av vegen i systemer som ikke håndterer at metreringsretningen er motsatt av den geometriske lenkeretningen. Flere har løst dette på egen hånd, men nå legger vi informasjonen direkte inn i API-responsen i Les V4 for enklere bruk. 

Ny node metrertLokasjon under "Lokasjon/Vegsystemreferanser" inkluderer: 

  • retning – Stedfestet retning, men snudd dersom metreringsretningen er MOT
  • sideposisjon – Stedfestet sideposisjon, men snudd dersom metreringsretningen er MOT 
  • kjørefelt – Angir hvilket kjørefelt vegobjektet er plassert i (dersom det er satt for stedfesting) 

Hva betyr dette i praksis?

  • Dersom metreringsretning er lik geometriretning, forblir verdiene uendret. 
  • Dersom metreringsretning er motsatt av geometriretning, snus verdiene etter faste regler: 
    • Sideposisjon bytter plass: H <> V, MH <> MV, HT <> VT
    • Kjørefelt endres: 
      • Oddetall: +1 (f.eks. felt 1 blir felt 2) 
      • Partall: -1 (f.eks. felt 2 blir felt 1) 
  • Gjelder kun første del av feltkoder dersom disse har tilleggsegenskaper (f.eks. 1V1 endres til 2V1). 

Hva betyr dette for brukere av Les API?

  • Systemer kan hente ut riktig felt, sideposisjon og retning direkte fra metrertLokasjon, i stedet for å måtte beregne dette selv. 
  • Informasjonen vil også bli tilgjengelig for bruk i Vegkart. 
  • Dataene i Les API-v4 vil fortsatt være identiske med det som er registrert via Skriv API, men denne tilleggsinformasjonen gjør det enklere å bruke dem direkte. 

Vi henviser til siden Migrere fra V3 til V4 for flere detaljer, blant annet oversikt over forskjeller mellom v3 og v4.

Gi oss en tilbakemelding dersom dere har noen spørsmål eller oppdager noe feil med Vegforvalter som filtreringsparameter eller metrertLokasjon, enten via kontaktskjemaet eller nvdb-api@vegvesen.no.

· 2 min lesetid

I nyhetsartikkelen Ny NVDB-kjerne midlertidig ikke tilgjengelig (API-v4) lanserte vi en plan om å midlertidig gjøre den nye NVDB-kjernen utilgjengelig, med mindre dette skapte problemer for våre brukere. Etter tilbakemelding fra noen brukere har vi justert planen.

Dersom dere har tatt i bruk første versjon av ny NVDB-kjerne, altså Les API-v4 med tilbakefall til v3, i produksjon, vil denne forbli uendret og tilgjengelig, frem til starten av mai. Er dere interesserte i å teste ut siste versjon av ny NVDB-kjerne, altså Les API-v4 uten tilbakefall til v3, er den nå tilgjengelig i test. Hvis ingen store feil oppdages under testingen, vil den erstatte versjonen i produksjon i starten av mai. Konkret lanseringsdato blir annonsert etter påske.

Deretter får vi en midlertidig periode hvor både Les API-v3 og Les API-v4 er operative samtidig. Dette sikrer en smidig overgang mellom de to systemene, og gjøre det mulig for systemer og tredjepartsverktøy å tilpasse seg den nye løsningen gradvis, uten at eksisterende arbeidsflyter og integrasjoner blir brått avbrutt. Denne fasen vil vare til august 2025. Da er det planlagt avvikling av API Les-v3, så sett av tid til å gjennomføre overgangen.

For teknisk interesserte:​

Nåværende Les i PROD Bilde: En visualisering av hvordan de ulike endepunktene og tjenestene henger sammen for LES API i produksjon akkurat nå

Ny NVDB-kjerne forblir tilgjengelig i sin første versjon, Les API-v4 med tilbakefall til v3, i produksjon. Dette gjelder:

  • uversjonert https://nvdbapiles.atlas.vegvesen.no
  • versjonert https://nvdbapiles.atlas.vegvesen.no/*tjeneste*/api/v4/

Versjonert https://nvdbapiles.atlas.vegvesen.no/*tjeneste*-blue/api/v4 peker mot Les API-v4 uten tilbakefall til v3. Sistnevnte er i akseptansetest, og APIet anbefales kun til testbruk.

Nåværende Les i UTV og PROD, uten tilbakefall til v3 Bilde: En visualisering av hvordan de ulike endepunktene og tjenestene henger sammen for LES API i UTV/ATM-miljøene akkurat nå

Les API-v4 med tilbakefall til v3 er ikke lenger tilgjengelig i UTV og ATM, og har kodefrys.

Les API-v4 uten tilbakefall til v3 er tilgjengelig i ATM for testing, på begge endepunkt. Dette gjelder:

  • uversjonert https://nvdbapiles.test.atlas.vegvesen.no/
  • versjonert https://nvdbapiles.test.atlas.vegvesen.no/*tjeneste*/api/v4/

Vi inviterer alle brukere inn i testmiljøet for å verifisere at dere klarer å bytte om, uansett om dere bytter direkte fra API-v3 http://nvdbapiles-v3.atlas.vegvesen.no/ eller fra API-v4 med tilbakefall til v3. Vi henviser til siden Migrere fra V3 til V4 for flere detaljer, blant annet oversikt over forskjeller mellom v3 og v4.

Gi oss en tilbakemelding dersom dere oppdager feil eller har noen spørsmål, enten via kontaktskjemaet eller nvdb-api@vegvesen.no.