API Dokumentasjon V2 og V3

Dokumentasjonen for NVDB-APIene LES og SKRIV er nå flyttet hit:

Og vil i fremtiden oppdateres der. Begge sidene inneholder lenke til en spesifikasjon av det nye API V3 (både les og skriv) som vil utvikles som følge av region-reformen. V3 dokumentasjonen er laget i apiary, med eksempel-responser og lenke til tilbakemeldingskanal på Gitter. V3 skal gå i produksjon høsten 2019 og være i drift fra 1.1.2020.

Program for Utviklerdag for Åpne Vegdata Fredag 27. oktober

Utviklerdag for Åpne Vegdata – Vegen til APIet til vegen

Vi ønsker å skape en samarbeidsarena for systemeiere, utviklere og leverandører som jobber med våre data. Det blir derfor også i år arrangert en utviklerdag for Åpne Vegdata i forlengelsen av Statens Vegvesens teknologidager.

Bli med og påvirk fremtidens Åpne Vegdata!

https://www.vegvesen.no/fag/fokusomrader/Forskning+og+utvikling/Teknologidagene/teknologidagene-2017

  • Tid: Fredag 27. Oktober kl10-15
  • Sted: Clarion Hotel & Congress i Trondheim
  • Møterom: Cosmo 3A
  • Påmelding: https://goo.gl/kKbbaC

Program

Programmet er delt i to deler – en generell del med fokus på oversikt og overordnet presenasjon av løsningene før lunsj og en mer detaljert del med fokus på detaljer etter lunsj.

Tid Innhold Foredragsholder
1000 Velkommen Per Andersen, Leder av Nasjonal VegdataBank – NVDB
1010-1100 Oversikt over Åpne Vegdataporteføljen
Overordnet presentasjon over APIene og prinsippene bak.

Annonseringer

  • Oppdatert dokumentasjon på GitHub Pages
  • Etablering av Referansegrupper for API LES og SKRIV
  • Utfastingsdato for API LES V1
Terje Brasethvik, NVDB & Geodataseksjonen, Vegdirektoratet
1100-1200 Demonstrasjoner / diskusjoner om  bruk

  • VegAR – vegdata på mobilen
  • Datainn – egen løsning for trafikkdata
  • Ulykker i mørket
Martin Bårnes, Kantega
Lars Meisingseth, Prosjektleder Datainn, Vegdirektoratet, trondheim
Terje Brasethvik, NVDB & Geodataseksjonen
1200-1300 Lunsj
1300-1400 LES / Vegkart

  • Demonstrasjoner
  • Detaljert presentasjon
  • Spørsmål og svar
  • Påmelding til referansegruppe
Marvin Lillehaug, Kantega
1400-1500 Skriv / Datafangst

  • Demonstrasjoner
  • Detaljert presentasjon
  • Spørsmål og svar
  • Påmelding til referansegruppe
Terje Brasethvik, NVDB & Geodataseksjonen, Vd

Espen Hjertø og Jostein Munz, Kantega

1500 Takk for i dag!

Velkommen!

NVDB og Geodataseksjonen, Vegdirektoratet, Trondheim

Feilrettinger i vegkart

Vårens leveranse av vegkart hadde dessverre med seg noen småfeil. En del av disse skal nå være rettet:

  • Filtrering på dato-egenskaper må «fnuttes» (se: https://www.vegdata.no/2017/08/01/hjelp-jeg-far-ikke-filtrert-trafikkulykker-pa-ulykkesdato/) – man behøver ikke lengre skrive anførselstegn!
  • Filtrering på har verdi / har ikke verdi på tekst-egenskaper: disse gav helt feil resultater, men det skal nå være i orden.
  • Verdi-feltet blir borte av og til: Det kan sikkert virke som om vi gjør det med vilje, men det er altså ikke meningen.
  • Kontraktsområdefilter viste i enkelte tilfeller objekter fra hele landet (i kartet) når du begynner å flytte deg i kartet.
  • Ett ekstra zoom-nivå: Vegkart bytter til kartverk-kart helt innerst for å få mer detaljer. Der får vi nå et ekstra zoom-nivå.
  • Gamle/ugyldige URL’er får feilmelding. I noen tilfeller klarer vi ikke å tolke gamle URL’er, vegkart blir bare stående å henge. Vi klarer fremdeles ikke tolke alle gamle eller ugyldige URL’er, men nå vil du i det minste få en feilmelding.

Rask tilgang til NVDB-data i ArcMap

Versjon 2.06_FIKSA klar til bruk

Vi har retta feilen i versjon 2.06, ny versjon finnes her (zip),

Eller du kan rette den opp sjøl på din egen maskin med denne oppskriften.

Våren 2020 fikk vi problemer med denne plugin, dels fordi vi skiftet adresse til NVDB api, dels fordi håndtering av paginering i plugin ikke var robust mot endringer i sidestørrelse. Det første (feil lenke til NVDB api) kan lett fikses ved å endre ei linje i tekstfilen <Mappe der du lagret plugin>\nvdb_access\config\config.yaml. Linje 5, der det står baseurl skal ha verdien  https://nvdbapiles-v2.atlas.vegvesen.no.

Linje 5 skal altså se slik ut:

baseurl: https://nvdbapiles-v2.atlas.vegvesen.no

Feilen i paginering rettes ved å kommentere ut linje 1008 og 1009 i fila <Mappe der du lagret plugin>\nvdb_access\da\data_da.py. Sett inn hashtagg # først på linje 1008 og 1009 – slik:

   # Break if we get less than the limit 
#   if nelem < max_pr_request: 
#        break    

Takk til Geodata A/S, som hjalp til med verdifull feilsøking og feilretting.

Statens vegvesen har i samarbeid med Geodata AS laget et programtillegg, NVDB Addin, som henter data direkte fra NVDB og inn i ArcMap. Verktøyet kommuniserer med NVDB API v2 og gjør data fra NVDB lett tilgjengelig for videre bearbeiding i ArcMap. Programtillegget deles fritt. Kildekode

Les videre

I 2016 hadde vi 423 millioner oppslag mot NVDB api

423 millioner oppslag er jo en del. Klientapplikasjonen «Ukjent» står for mesteparten, med vegkart som god nummer 2.

For din egen del er det lurt om du angir X-Client og X-Kontaktperson i headeren på kallet, slik som beskrevet her:

"X-Client": "NVDB Rapporter" 
"X-Kontaktperson": "ola@nordmann.no"

Da får vi muligheten til å kontakte deg om noe er galt, og din applikasjon kommer med i statistikken.

statistikk-forenklet-2016

FME eksempel for segmenterte data

Jeg har laget et FME workspace som utnytter muligheten til å få «delt opp» lange objekter i kortere segmenter. Hvert segment har unike vegreferanseverdier og veglenkeposisjoner. (I tillegg unngår man alle «multilinestring» – geometrier).

Trikset er nøkkeordet inkluder=vegsegmenter (evt inkluder=alle). Slik:

https://www.vegvesen.no/nvdb/api/v2/vegobjekter/616/91452898.xml?inkluder=vegsegmenter

Med NVDB api V2 kan man velge å få lange objekter delt opp i segmenter med unike vegreferanseverdier og veglenkeposisjoner

Med NVDB api V2 kan man velge å få lange objekter delt opp i segmenter med unike vegreferanseverdier og veglenkeposisjoner. Dokumentasjon

Det vil si at i stedet for:

  • en geometri for hele objektet
  • en liste med vegreferanser
  • en annen liste med veglenker
  • og plunder med å koble en veglenke-bit til riktig vegreferanse + riktig bit av geometri

Så får vi

  • Ett eller flere segmenter
  • Hvert segment har sin egen «bit» av objektet med
    • En enkel vegreferanseverd  (med unike  vegnummer hp, frameter og tilmeter)
    • En bit av en enkelt veglenke (ID, fraposisjon, tilposisjon)
    • Geometrien som hører til.

https://github.com/LtGlahn/Nvdbapi_v2_FME#nvdbapi_v2_bruksklassefmw