6 innlegg merket med "API Les"

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.

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.

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:​

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.

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.

Programmet Digital Drivkraft har siden 2022 jobbet med å forbedre våre tjenester i Nasjonal vegdatabank. En av oppgavene er å gjøre NVDB-kjernen robust og fremtidsrettet. Denne oppdateringen skjer i en stegvis prosess, og vi går nå inn i en ny fase.

Siden november 2024 har det vært tilgjengelig en første versjon av nytt Les API-v4, som brukere har fått teste ut og gi tilbakemelding på, enten ved å aktivt velge nytt API på Vegkart.no eller direkte via URL. Fra tirsdag 8. april vil denne versjonen fjernes. Valget på vegkart.no og URL-adressen vil fortsatt være tilgjengelige, men innholdet vil hentes fra det gamle systemet Les API-v3.

Denne fasen vil vare frem til starten av mai. Da er det planlagt en re-lansering av API LES-v4, og vi vil gå inn i siste fase av oppdateringen, altså den midlertidige perioden hvor både Les API-v3 og Les API-v4 er operative samtidig. Dette vil sikre 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: Uversjonert URL vil peke til LES API-v3, men versjonert versjon vil peke til LES API-v4 uten tilbakefall til v3. Sistnevnte har kjente feil per nå, og API’et anbefales kun til testbruk. Vi henviser til siden Migrere fra V3 til V4 for flere detaljer, bl. oversikt over forskjeller mellom v3 og v4 dere må hensynta før nytt API kan tas i bruk.

Gi oss snarest en tilbakemelding dersom dette skaper problemer for dere, enten via kontaktskjemaet eller nvdb-api@vegvesen.no.

Velkommen til NVDB API Les V4 - den nyeste versjonen av NVDB API Les!

Vi har utviklet V4 fra grunnen for å sikre økt stabilitet, skalerbarhet og fleksibilitet i endringer. En første versjon av APIet er nå tilgjengelig, og vi ser frem til tilbakemeldinger fra brukere som ønsker å migrere fra V3 til V4. Endringer i OpenAPI-spesifikasjonen er også implementert for å forbedre brukervennligheten og forståelsen av APIet.

Se mer informasjon, dokumentasjon og migreringsguide her.

Det er per i dag 25-40% av belastningen på NVDB API Les av konsumenter som ikke identifiserer seg. I utviklings- og testmiljøene (STM, ATM) har nå X-Client headeren blitt satt som påkrevd og ikke bare anbefalt. X-Client i produksjon er estimert til september. Les mer og se eksempler her.