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.

NVDB åpne vegdata utviklerkonferanse 2016

Edit 6.9.2016programmet er nå klart

Tid: Fredag 23. September kl 10-15

Sted: Clarion Hotel & Congress, Trondheim

Påmelding

Program

Vi vil i år – som i fjor – avholde en utviklerkonferanse for dere som jobber med utvikling rundt våre åpne data og apier.

Vi driver i disse dager og setter sammen programmet for dagen og ønsker oss at dere som har interesse av å komme svarer på en superkort spørreundersøkelse:

https://no.surveymonkey.com/r/VDH83P8

Det er 3 avkrysningsspørsmål og 2 kommentarfelt – vi setter stor pris på tilbakemelding! Endelig program for utviklerdagen blir sendt ut i løpet av de nærmeste ukene.

Grensesnittene utviklet i åpne vegdata prosjektet:

I 2016 har vi lansert versjon 2 av NVDB lese-api og en utviklerutgave av NVDB skrive-api. Til konferansen håper vi også å kunne presentere en første versjon av et datafangst-api.

Ressurser for utviklere

Følg oss også på twitter @nvdbapi


Påskeegg, replikeringsfeil og datafeil i kontraktsområdene

Søkeindeksen bak vegkart og NVDB-apiet betjenes av 5 søkemotor-noder. Vi opplever fortiden problemer med at disse nodene er kommet i utakt som en følge av feil med replikeringen. Dette påvirker responsen for alle objekttypene i NVDB, spesielt dersom du søker med områdefilter. Vi må derfor gjøre om på oppsettet av disse nodene og deretter foreta en full reindeksering. Vi håper å få dette gjort så fort som overhode mulig, kanskje allerede i kveld, senest i løpet av påskeuken.

Vi har også en datafeil med kontraktsområdene våre. Det har blitt opprettet uhorvelig mange kontraktsområder i enkelte kommuner og dette har trigget en feil i API’et. Her jobber vi med å rette opp data og korrigere API’et; dette håper vi er på stell like over påske.

God påske.

Utviklerutgave av skrive-apiet tilgjengelig på docker-hub

Vi har nå gleden av å tilby en utviklerutgave av NVDB Skrive-API. Denne er tilgjengelig via docker-hub. Utviklere som ønsker å skrive data til NVDB kan dermed få kjøre en virtuell utgave av  skrive-apiet på sin maskin.

Om NVDB skrive api

Skrive-apiet er et asynkront REST-API som tar imot Endringssett på vårt eget vegobjekt-format. Skrive-apiet er tett knyttet opp mot NVDB og Datakatalogen. For å kunne bruke Skrive-API’et i produksjon, må du:

  • Ha bruker i Statens Vegvesen, med NVDB roller i LDAP
  • Få tildelt datarettigheter i skrive-apiet til de objekttypene, de vegkategoriene og de områdene du ønsker å skrive data for.
  • Ha kjennskap til Datakatalogen: Alle objekter som skal skrives blir strengt validert mot siste utgave av datakatalogen.
  • Ha kjennskap til Vegnettet i NVDB: Skrive-apiet krever at objekter er stedfestet på vegnettet (med angitt veglenkeid og posisjon).

En oversikt over NVDB API’ene, med tilhørende kode-eksempler er tilgjengelig her: https://github.com/nvdb-vegdata/nvdb-utviklerkonferanse-2015 Dokumentasjonen til skrive-apiet pakkes og distribueres sammen med applikasjonen og er inkludert i utviklerutgaven.

Om utviklerutgaven

Denne utviklerutgaven mocker all Statens vegvesen infrastruktur, inkludert NVDB databasen, men lar deg få lov til å utforske kommunikasjonen med API’et og validere dine data. Denne varianten har ingen vegdata og skriver heller ingen data til NVDB. Det er altså bare for å kunne utvikle mot APIet. Den inneholder imidlertid siste versjon av datakatalogen og kan validere innsendte data mot denne.

Docker-utgaven oppdateres når vi oppdaterer skrive-apiet i akseptansetestmiljøet, den vil altså følge neste produksjonskandiat av apiet. Datakatalogen oppdateres fortløpende.

For å få tak i docker-utgaven:

  1. Installér Docker https://docs.docker.com/engine/installation/
  2. Kjør docker run -d -p 8080:8080 –name nvdb-skriveapi nvdbapnevegdata/nvdb-skriveapi
  3. For å stoppe kjør docker stop nvdb-skriveapi

Når docker kjører:

Om alt har gått bra er Skrive-apiet nå tilgjengelig på http://localhost:8080/ på en Linux-maskin. For Windows og Mac kjører docker daemon i en Linux VM og localhost må erstattes med korrekt IP-adresse. For å finne denne åpne et command prompt/terminal og kjør kommando docker-machine ip.

Når man åpner denne siden i nettleseren vises en side der man kan velge innlogging. Dette er ikke knyttet til reelle brukere, men dummybrukere som kun lever i SDKen. Når bruker er valgt vil man bli sendt til /nvdb/apiskriv. Her ligger lenke til dokumentasjonen av APIet, og en testklient som kalles Generator.

Generator-klienten viser eksempler på requester som sendes til APIet, og forventet respons fra APIet.

Logge inn i skrive-apiet programatisk

For å opprette en sesjon programmatisk kan du POSTe ønsket user-id til /login (eks: user-id=toillbaill). Da blir en serversesjon opprettet. For å bruke denne sesjonen må du bruke JSESSIONID-cookien som returneres ved login.

Feilsøk:

Loggene til Skrive-APIet nås ved å utføre:

docker exec -it nvdb-skriveapi bash
cd maven/apache-tomcat-8.0.32/logs