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)
- Sideposisjon bytter plass:
- 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.