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
24.1.3
Endringer
- /dokumentasjon/openapi/ virket ikke i 24.1.2
- Konfigurerbar begrensning av sidestørrelser - Oppdatert max pagesize for flere objekttyper som f.eks: 577, 580, 106, 107
24.1.2
Endringer
- Kjører med nyere Springboot(2.7.9 -> 3.1.5) , Solr (8.7 -> 8.11.3) og Zookeeper (3.6 -> 3.8.4)
- Oppgradert fra Tomcat 9 til 10 og dermed fra javax til jakarta
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)
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
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
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
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
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
Sprint 14
- Gir ut segmentert vegnett
- Gir ut segmenter og vegsystemreferanser for vegobjekter
- Vegkart-versjon som bruker Les V3
Responsendringer
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.