NVDB API LES V3 - Endringslogg og implementasjonsplan

Dette er endringer vi har gjort i hver sprint som er synlige for konsumenter av V3.

Oversikt over hvilken installasjon som er installert i hvilket miljø:

• UTV - https://nvdbapiles-v3.utv.atlas.vegvesen.no/status/versjoner
• STM - https://nvdbapiles-v3-stm.utv.atlas.vegvesen.no/status/versjoner
• ATM - https://nvdbapiles-v3.test.atlas.vegvesen.no/status/versjoner
• PROD - https://nvdbapiles-v3.atlas.vegvesen.no/status/versjoner

Se mer dokumentasjon om NVDV API LES V3: her

Fullførte versjoner

2024.1.4 (15.04.2024)

Feilrettinger

• Fikset at metrics ikke forsvinner når API Les har kjørt en stund.

2024.1.2 (15.04.2024)

Feilrettinger

• Rettet feil hvor avrunding av geometri kunne skape tomme geometrier.

2024.1.1 (09.01.2024)

Endringer

• Gi alltid ut egengeometri for usegmenterte vegobjekttyper.

---

2023.2.22 (22.11.2023)

• Rettet feil med nedlasting av binære filer

2023.2.18 (30.10.2023)

• Historiske vegobjekter som har vegsegmenter kommer ut i responsen, likt som aktive vegobjekter, gitt
• at parameter segmentering=true sendes med.

2023.2.17 (19.10.2023)

• Skrive ut objektid for gateid sammen med adressenavn og adressekode på segmenterte veglenkesekvenser

2023.2.15 (11.10.2023)

• Akseptere id_token utstedt fra idporten

2023.2.12 (8.9.2023)

• Utvide /omrader/fylker og /omrader/kommuner med ny egenskapstype Organisasjonsnummer
• Intern fiks: Helsesjekk rapporterte problemer - blant annet SQLRecoverableException

2023.2.10 (31.08.2023)

• Retting for ugylde tegn ved utheting i XML-format
• Retting for sensitive data
• Feilretting for oversetting mellom vegreferanse og vegsystemreferanse
• Kommunenummer i vegsystemreferanse for KPS veger feilet
• Det var en feil i generering av URL for neste side med data du kan hente (i elementet metadata).
• RefreshToken brukt på auth/refersh-endepunktet fungerte ikke
• Endepunket /beta/ruteberegning feilet når man sende inn null-verdier på POST-request

2023.1.0 (06.03.2023)

• Polygoner som overskrider grensen rundt Norge gir nå resultat fra det gyldige området
• Gjort mulig å ha kommunenummer i starten av vegsystemreferanse parameter på enkelte endepunkt (se API dokumentasjon)

2023.1.0 (04.01.2023)

• Innsendte polygoner blir nå forenklet
• Les tillater nå POST spørringer for å motta større spørringer

2022.1.23 (02.12.2022)

• Oppdatert bibliotek for strenghåndtering

2022.1.18 (31.10.2022)

• Filtrering med vegsystemreferanse på Statistikk for vegobjekter
• Gjort mulig å hente ut egenskaper som mangler eier
• Oppdatert test for egenskaper
• Endret SRID i respons for projeksjoner:
  • UTM32 - 25832 → 5972
  • UTM34 - 25834 → 5974
  • UTM35 - 25835 → 5975

    2022.1.17 (10.10.2022)

• Hotfix for ugyldig JSON serialisering av egenskaper

2022.1.16 (06.10.2022)

• Oppdatert biblioteker for logging

2022.1.15 (05.10.2022)

• Fiks for gatenavn med ‘/’ som tidligere ble skrevet om til “nedre”
• Nytt endepunkt for å hente ut informasjon om egenskapstype og hvilken vegobjekttype den hører til

2022.1.14 (23.09.2022)

• Objekter returneres med 8 desimaler for response i WGS84-koordinater, og 3 desimaler for respons i UTM-koordinater.
• I tillegg til UTM33 er det nå lagt inn UTM 32 - 35.
• Parameter trafikantgruppe under /posisjon er beskrevet i API-dokumentasjon

(Versjon 2022.1.13 ble hoppet over)

2022.1.12 (16.09.2022)

• Søk på vegobjekt med “alle_versjoner=true” og veglenkesekvens=posisjon@veglenkesekvens henter ut historiske objekt
• Lagt til trafikantgruppefiler på /posisjon

2022.1.11 (13.09.2022)

• Fiks for søk på vegobjekt med “alle_versjoner=true” - skal gi treff på historiske vegobjekt

2022.1.10 (12.07.2022)

• NVDB API Les V3 kan kalles fra lokal server (If-None-Match to Access-Control-Allow-Headers)

2022.1.9 (16.06.2022)

• Gatenavn som Stjerneveien øvre ble feilaktig skrevet om til Stjerneveien svingen for segmentert vegnett

2022.1.8 (14.06.2022)

• Oppgradering av bibliotek - sikkerhetsfikser

2022.1.5 (14.01.2022)

• Dataguard i Produksjon: NVDB API Les V3
• Statistikkendepunkt finner ingen kontraktsområder med fylke-filter

2022.1.3 (14.01.2022)

• Søk på kartustnitt med lat/lon (wgs84) gav feil resultat (for mange treff)
• Paginering på kontraktsområde med tegnet ‘&’ i navnet, gav uriktig href for neste side

2022.1.1 (28.01.2022)

• Gi tilbakemelding dersom geometri for ruteberegning er utenfor område (kooridnater skal være i UTM33)

2022.1.0 (20.01.2022)

• Fiks uttak av statisitkk ved bruk av datofilter

2021.12.1 (04.01.2022)

• Inkluder tidspunktparameter på veg? og posisjon?

2021.14.0 (16.12.2021)

• Sikkerhetsfiks for Log4J
• Typeveg utvidet med verdiene “traktorveg”, “sti” og “annet”

2021.8.2 (01.11.2021)

• Tilbakemelding om ikke indekserte objekttyper
• Srid og inkluder i /vegobjekt
• Fiks for tidspunkt paramter for /vegobjek
• Rettet i dokumentasjon (blant annet lenke til “SVV Håndbok V830” feilet)

2021.8.0 (19.08.2021)

• Fjerning av bakoverkompatibilitet mot tidligere håndtering av kontraktsområde og riksvegruter
• Login-tilgjengelighet

2021.7.0 (17.06.2021)

• Historikk på vegobjekter (historikk-parameter)
• Tilbakemelding om ikke-indekserte typer

2021.6.0 (27.05.2021)

• Modifisering av /vegobjekt-endepunktet. Støtter nå flere parametere og sluttdato. Se dokumentasjon på /vegobjekt.

2021.5.2 (15.04.2021)

• Oppdatert SRID til nyeste standard + dokumentasjon

2021.5.1 (17.03.2021)

• Bedre håndtering av JSON for gate-spørringer

2021.5.0 (05.03.2021)

• Fikset at gate.sideveg ikke ble returnert fra /vegnett/veglenkesekvenser/segmentert/X når gate tilknyttet segmentet er sideveg
• Fikset at gate.sideveg ikke ble returnert fra /vegobjekter/X?inkluder=alle når gate tilknyttet vegobjektet er sideveg.

2021.4.0 (19.02.2021)

• Fikset at filter 0@123 og 1@123 ikke returnerer forventede objekter.
• /vegobjekter/946?fylke=X returnerer forventede objekter.
• Filtrering på ikke-eksisterende riksvegrute vil gi feilmelding.
• /omrader/kontraktsomrader,riksvegruter grupperer objekter som tilhører samme logiske kontraktsområde/riksvegrute. For responsrevisjon 1 vil kun laveste id av disse objektene vises. Responsrevisjon 2 (Accept: application/vnd.vegvesen.nvdb-v3-rev2+json) er innført, med denne vil alle objekter bli referert. Responsrevisjon 1 er fortsatt revisjonen som blir returnert dersom revisjon ikke er spesifisert. Det vil komme flere endringer for responsrevisjon 2.

2021.2.1 (11.02.2021)

• Fikset bug i geometrien til strekningsobjekter
• Endepunktene /omrader (untatt /omrader/gater) og /vegobjekttyper går fra å bruke cache i en uke til å bruke cache om ETag matcher nyeste versjon

2021.1.0 (08.01.2021)

• Forbedring av ruteberegning
• /omrader/gater pagineres

2020.20.0 (17.11.2020)

• Forbedring av ruteberegning

2020.19.0 (10.11.2020)

• Forbedring av ruteberegning

2020.17.0 (15.10.2020)

• Forbedring av ruteberegning

2020.16.0 (15.10.2020)

• Forbedring av ruteberegning
• Vegsystemreferanse ble ikke slått sammen for segmenterte vegobjekter

2020.15.0 (22.09.2020)

• Forbedring av ruteberegning

2020.14.0 (01.09.2020)

• Forbedre tilfeller der /veg veksler mellom flere responser ved re-lastinger.
• Fikset at /vegobjekter/X?veglenkesekvens=Y ikke returnerte objekter dersom vegobjekt var stedfestet mot veglenkeretning.
• Respons fra ruteberegning endret til å inneholde et statusfelt
• /omrader/kontraktsomrader og /omrader/riksvegruter inkluderer kommuner og fylker på returnerte objekter.
• Fikset at /veglenkesekvenser/segmentert/X returnerte objekt dersom det var kun ett segment.

2020.13.0 (18.08.2020)

• Mulig å ekskludere assosiasjon- og stedfestingsegenskap. (?inkluder_egenskaper=alle|basis|geometri|assosiasjon|stedfesting)
• Ta imot veglenketype som liste i vegnettssøk. (?veglenketype=hoved,detaljert)
• Fjern støtte for responsrevisjon 0
• objekt.geometri vil alltid være egengeometri dersom objektet har dette.

2020.12.0 (25.06.2020)

• Intern begrensning på antallet samtidige forespørsler som behandles. Klienter kan få 503 Behandlingen av forespørselen kunne ikke fullføres innen rimelig tid.

2020.11.0 (23.06.2020)

• Fikset at noen objekter manglet segmentert geometri

2020.10.0 (16.06.2020)

• Fikset manglende geometrifelt i lokasjon
• Fikset vegsystemreferanse mangler i lokasjonsobjekt for vegobjekter-søk

2020.9.0 (02.06.2020)

• Fikset søk på vegobjekt med dybde>=2 gir ukomplette relasjoner

2020.7.0 (17.05.2020)

• Fikset manglende vegsegmenter ved inkludering av vegsegmenter

2020.6.0 (17.03.2020)

• Fikset feil ved summering av strekningslengde med egenskapsfilter

2020.5.0 (05.03.2020)

• Overgang fra NN 1954 til NN2000

2020.3.0 (11.02.2020)

• Geometri.kvalitet.medium_nvdb lagt til for å gi ut verdi lagres i NVDB

2020.2.0 (24.01.2020)

• Vekslende svar fra /posisjon for nærliggende lenker
• Verdier i Geometri.kvalitet har ikke rett verdi.

2020.1.0 (14.01.2020)

• X-Client-User-Agent-kombinasjoner vi mener ikke er gode nok vil bli blokkert
• Bugfikser for /veg og /posisjon

2019.17.0 (20.12.20219)

• Det gjøres ikke lengre snuing av segmenter der Strekning(916) er stedfestet mot lenkeretningen. Se https://api.vegdata.no/v3/retning.html

2019.16.0 (15.11.2019)

• /vegnett/elementer fjernet

2019.15.0 (23.10.2019)

• Ikke feil med HTTP 500 når det er feil i egenskapsfilter

2019.14.0 (11.10.2019)

• Meterverdier rundes av til tre desimaler. For geometri på UTM33-format er det også tre desimaler, WGS84-geometri rundes til åtte desimaler.

2019.13.0 (08.10.2019)

• Fikset duplikater ved paginering av transaksjoner

2019.12.0 (16.09.2019)

• Fikset at trafikantgruppe ble ignorert i vegsystemreferanse-filter
• Antall 0 ved statistikkspørring med egenskap=area(x)
• Primitivt endepunkt for finne rute mellom to veglenkesekvensposisjoner/koorinater

2019.11.0 (3.9.2019)

• Response fra /veg har riktig kommune (var alltid 0)
• Stedfesting for Svingerestriksjon er komplett representert
• Responsrevisjon 1
• Første versjon av referanseklient i java releaset.

2019.10.0 (8.8.2019)

• Stedfestingsegenskaper har fått nytt felt: stedfestingstype: Punkt|Linje|Sving

Sprint 22

• transaksjon.tidspunkt hadde format yyyy-MM-dd HH:mm:ss - dette er endret til ISO-8601.
• metadata.sidestørrelse er lagt til i responsen for å signalisere faktisk sidestørrelse ved paginering.

Sprint 20

• Avansert spørring virker igjen

Sprint 21

• /status gir ut informasjon om hva NVDBIND gjør.
• Retning på stedfestingen av Strekning, Kryssystem og Sideanlegg gis ut i segmentert vegnett.
• /vegobjekter/X, /vegobjekter/X/statistikk, og /vegnett/veglenkesekvenser/segmentert støtter parametret ?tidspunkt. Dette filtrer ut de vegobjektene/vegnettsegmentene som var åpne på det gitte tidspunkt. Dersom segmentering er aktivert for vegobjekter vil vegobjektenes geometri- og lokasjons-egenskap ha innhold basert på de segmentene for objektet som var aktiv på dette tidspunktet.
• Det er mulig å hente ut vegobjekter som er oppdatert etter et gitt tidspunkt med /vegobjekter/X?endret_etter={ISO-tidspunkt}. Som i V2 er denne litt sensitiv, så det er ikke nødvendigvis synlig forskjell på et objekt selv om det dukker opp med denne filtreringen.
• /vegobjekter/X, /vegobjekter/X/statistikk, og /vegnett/veglenkesekvenser/segmentert har fått flere muligheter for å filtrere på egenskaper fra vegsystemreferansen. Se arm, veglenketype, adskiltelop, typeveg, detaljniva, kryssystem, sideanlegg, trafikantgruppe i dokumentasjonen

Responsendringer

• kvalitet.synlighet endret til synbarhet
• stedfesting.feltoversikt endret til kjørefelt
• veglenkesekvens.måleMetode,måleDato endret til målemetode,måledato
• Porttilkobling på veglenkesekvens/node: portid endret til portnummer, netelementid endret til nodeid om port peker på node, netelementid endret til veglenkesekvensid om port peker på node netelementtype og netelementtype_tekst fjernet

Sprint 19

• /omrader/regioner, /omrader/vegavdelinger er fjernet
• Fylker og kommuner hentes fra objekttype 945 og 946
• ?segmentering=true med områdefilter virker igjen.
• /veg virker igjen

Sprint 18.1

• Felt på vegobjekttype for å vise at det skal kun eksistere én versjon av et vegobjekt.

Responsendringer

• vegobjekttype.en_versjon

Sprint 18

• Autentisering for tilgang til sensitive datatyper og egenskaper. (https://apilesv3.utv.atlas.vegvesen.no, kun personlige brukere)
• Vegkart støtter å filtrere på vegsystemreferanse

Sprint 17

• Funksjonalitet for autentisering og eksponering av sensitive vegobjekttyper og egenskaper
• Filtrere usegmentert vegnett basert på vegreferanse
• srid=32633 erstattet med 6173

Responsendringer

• vegobjekttype.sensitiv

Sprint 16

• Filtering av vegobjekter med vegsystemreferanse
• Segmenter inkluderer kontraktsområde og riksvegrute
• Meterverdier for objekters vegsystemreferanse var ikke tilpasset objektets stedfesting
• Maks sidestørrelse ved paginering er økt til 50 000

Responsendringer

• feltoversikt
• kontraktsområder og riksvegruter
• typeVeg_sosi for segmenter

Sprint 15

• Endepunktet /posisjon virker med vegsystemreferanse.
• Filtrering på vegsystemreferanse implementert.
• Vegkart: Klikk i kart viser vegsystemreferanse i punkt.
• Vegkart: Vegsystemreferanse vises i treffliste.

Responsendringer

• Veglenkesekvenser
• Segmentert vegnett
• Vegobjekter
• Statistikk (strekningslengde er endret til lengde)

Sprint 14

• Gir ut segmentert vegnett
• Gir ut segmenter og vegsystemreferanser for vegobjekter
• Vegkart-versjon som bruker Les V3

Responsendringer

• Veglenkesekvenser
• Segmentert vegnett
• Vegobjekter

For oversikt over mulige verdier for feltene i responsen se API-dokumentasjonen

Sprint 13

• Segmentering av vegnett og vegobjekter
• Antallet desimaler i koordinater er begrenset til åtte.

Sprint 12

• Segmentering av vegnett og vegobjekter

Sprint 11

• /vegobjekter/#?id=x,y,z og /vegnett/…?id=x,y,z er endret til ?ider=x,y,z
• Gir endelig ut struktur, liste, liste med struktur, assosiasjon og liste med assosiasjoner.
• Takler / i navn for kontraktsområde og riksvegrute.
• egenskapen styringsparametere er fjernet fra vegobjekttyper og dems egenskaper. Mange av feltene under vegobjekttypens styringsparametre kommer fra dets lokasjonsegenskap. Alle verdiene vil bli listet ut der de kommer fra.
• Datakatalogverdier som ikke gis ut fordi de skal ut av datakatalogen eller alle instanser mangler verdi:
  • vegobjekttype.,tillattverdi.illustrationid
  • featuretype.filterOn
  • featuretype.coverage (alle instanser har verdi 1)
  • featurettype.context.description
  • featurettype.context.indexon
  • egenskapstype.no
  • lokasjonsegenskap.suppleringslengde (UPDATE_LENGTH)
  • lokasjonsegenskap.ajourhold_i (UPDATE_I)
  • lokasjonsegenskap.retning_relevant (DIR)
  • lokasjonsegenskap.flyttbar (transferable_between_levels)
  • lokasjonsegenskap.høyde (HEIGHT_LEVEL) / .høyde_relevant (heightlevel)
• Egenskaper som har endret navn:
  • ajourhold_splitt -> vegnettsajourhold_splitt
  • dekningsgrad -> overlappsautomatikk
  • overlapp -> overlapp_ok
  • sektype2_Ok -> konnekteringslenke_ok

Sprint 10

• Gir ut Turnextent
• Segmentering påbegynt
• /vegobjekter/#?id=x,y,z

Sprint 9. 4. september

• Lokasjons- og assosiasjonsegenskapene for et vegobjekt blir gitt ut som egenskaper i tillegg til den forenklede representasjonen vi allerede har.
• egenskap.datatype_tekst er fjernet, egenskap.datatype har verdien datatype_tekst hadde.
• egenskap.viktighet_tekst fjernet, egenskap.viktighet har verdien egenskap.viktighet_tekst hadde.
• transaksjonsobjekt.transaksjonstype_tekst fjernet, transaksjonsobjekt.transaksjonstype har verdien transaksjonstype_tekst hadde.
• veglenke.topologinivå_tekst fjernet, veglenke.topologinivå har verdien veglenke.topologinivå_tekst hadde.
• veglenke.detaljnivå har tekstverdier
• veglenke.typeVeg har tekstverdier
• veglenke.typeVeg_sosi har tekstverdier
• veglenke.målemetode har tekstverdier
• lenkesekvens, lenke er endret til veglenkesekvens og veglenke.
• stedfesting.felt er endret fra tekst til liste av tekst. (feltet kunne før være "1#2", dette er nå ["1", "2"])
• Felter lagt til i datakatalogen:
  • Assosiasjonsegenskaper med alle sine egenskaper. (grunnverdier + affiliation, feature_type_id, inside_parent, start_date, end_date, association_requirement, association_requirement_comment)
  • baseegenskaper: sosinavn, caption, readOnly, complementaryattrtypeid, plainviewreftext, heightreftext, reqheightref, reqaccuracyplan, reqaccuracyheight, referencesosi, referencegeometry, conditionalRequiremens.
  • Blobegenskap.blobformat
  • featuretype.state, category, simpleversionon, coverage, additionalinfo
  • Tekst. dato.-, tidegenskap.format
  • Integer., Real.complementarysign
  • Enum.isDefault
  • Localtional.movable, insideparent
  • PrimitiveAttribute.isdirectionsensitive, isextentsensitive
  • Spatial.insideparent

Navn i apiet:

• affiliation - tilknytning
• inside_parent - innenfor_mor
• association_requirement,
• association_requirement_comment
• sosinavn - sosinavn
• caption - ledetekst
• readOnly - skrivebeskyttet
• complementaryattrtypeid - komplementær_egenskapstype
• plainviewreftext - grunnrissreferanse
• heightreftext - høydereferanse
• reqheightref - høydereferanse_tall (tror dette er href, vil helst ikke brukt href siden det har annen mening i api)
• reqaccuracyplan - nøyaktighetskrav_grunnriss
• reqaccuracyheight - nøyaktighetskrav_høyde
• referencesosi - sosi_referanse
• referencegeometry - referansegeometri_tilstrekkelig
• conditionalRequirements - tilleggskrav
• blobformat - mediatype
• state - status (Mangler tekstverdier for denne)
• category - CATEGORY (Mangler tekstverdier for denne) Burde det vi allerede kaller kategorier kalles grupper?
• simpleversionon - simpleversionon (Trenger navn)
• coverage - dekning
• additionalinfo - tilleggsinformasjon
• format - feltmønster
• complementarysign - fortegnsendring_snu
• isDefault - standardverdi
• movable - flyttbar
• isdirectionsensitive - ajourhold_snu
• isextentsensitive - lengdeavhengig_verdi

Sprint 8. 14. august

• Støtte spørring med polygon
• /vegobjekter/{id} oppe med reelle data. Kontraktsområde har ikke historikk. Søkeparametre for vegsystemreferanse og avanserte spørringer virker ikke.
• Begrepsendring for vegnettet. Referanselenk -> Lenkesekvens, Dellenke -> Lenke
• I datakatalogen har vegobjekttypenes kategorier fått informasjon om primærkategori.
• Lenker har fått måledato, målemetode, typeVeg og detaljnivå
• Egenskaper som ligger inni geometrien blir eksponert.

Sprint 7. 26. juni

• Vegnettsgeometri og egengeomtri normaliseres til LINESTRING(Gis ut som MULTILINESTRING siden typen i NVDB er dette)
• Forbedringer av spørreparametre for noder
• Gi ut definisjonen av objekters geometriattributt i datakatalog. : vegobjekttype.stedfesting er lagt til denne gir informasjon om stedfestingen for vegobjekttypen. Dette feltet kan være et listeattributt som inneholder selve stedfestingsattributtet.
• attributtype.liste - felt er fjernet. attributetype.type er lagt til. Denne vil inneholde beskrive hvilken type attributtypen er, eks Liste.
• Datatype Liste, id 38 er lagt til for Listeattributter.
• vegobjekttype.relasjonstyper er endret slik at det vil komme et liste-nivå dersom den aktuelle assosiasjonen er en liste.

Sprint 6. 5. juni

• Definisjon av liste- og strukturattributter i datakatalog.

Sprint 5. 15. mai

• Innslag i tillatte_verdier har fått feltet navn endret til verdi Dersom det er et tall-enum er dette ikke lengre en streng.
• For et attributt på en vegobjekttype i datakatalogen manglet kortnavn og attributtypekategori. Dette er lagt til.
• Alle attributtyper listes ut på /vegobjekttyper/attributtypekategorier
• Geometriattributtyper manglet dimensjon. Dette er lagt til.
• Dersom et objekt er slettet fra NVDB gir apiet status 410 i stedet for 404.

Sprint 4. 24. april

• Indeksering og eksponering av objektert binær-egenskaper
• Eksponering av NVDB transaksjonslogg
• Indekserer lenker der alle lenker har sluttdato

Sprint 3. 3. april

• Parametre for filtrering av usegmenter vegnett
• Innføre segmentert vegnett (likt det i V2)

Sprint 2. 6. mars

• Indeksering og endepunkt for usegmentert vegnett

Sprint 1. 13. februar

• Dokumentasjon og spesifisering av endepunkter og responser
• Endepunker med blanding av reelle og dummy-data.

  Grov forventet fremdrift

Fremtid

• Gi ut informasjon om objekter som er oppdatert på grunn av endringer i vegsystemreferanse, kontraktsområde, eller riksvegrute.
• Alle endepunkter støtter POST der det er hensiksmessig
• Mulighet for å finne rute mellom to punkter på vegnettet.
• GeoJSON-respons
• Respons for vegobjekt-egenskaper reduseres til kun data, ikke felter for datatype, egenskapstypenavn.