KLIC API voor afwijkende situatie Pilot 12 juni 2019 Fuat Akdeniz Monique Schaafsma
Agenda Tijd Wat Wie 09:30 Welkom Fuat 09:45 10:15 Samenvatting Focus op Fase 3 Kadaster-Netbeheerder 10:30-11:45 Workshop Requirements (specifieke Requirements) - Toelichting Terugmelding API - Workshop 2 groepen Monique Jaap Willem 11:45-12:00 Vervolg Fuat/Monique 2 Agenda
Huidig proces Grondroerder Web formulier Netbeheerder Netbeheerder Netbeheerder KCC medewerker 3 POC KLIC terugmelden
POC Terugmeld API Doel: september 2019 Grondroerder Grondroerder app Melden Status opvragen Netbeheerder Netbeheerder Netbeheerder TMSAPI KCC medewerker KCC dashboard Status update Meldingen ophalen 4 POC KLIC terugmelden
Nadenken netbeheerders aansluiten op TMS API Grondroerder KCC medewerker Grondroerder app KCC dashboard Melden Status opvragen Status update Meldingen ophalen TMS API Meldingen ophalen Status update Netbeheerder Netbeheerder Netbeheerder Beheerderdata ophalen Beheerders ophalen KLIC BMKL API KLIC Organisatie API 5 POC KLIC terugmelden
6 Toelichting Terugmelding API
Terugmelding Bronhouder API- KLIC Jaap-Willem Sjoukema 12 juni 2019
Terugmeldapplicaties www.verbeterdekaart.nl Terugmelden op BGT en BRT bagviewer.kadaster.nl Terugmelden op BAG Filmpje https://www.youtube.com/watch? v=il4crqfqujs 8 Laagdrempelig terugmelden op basisregistraties
Onder water: één terugmeldsysteem BAG BAG viewer API BGT + BRT Front-end ( Verbeter de Kaart ) PDOK Terugmeldservices Mutatiemeldsysteem (SVB-BGT) API Terugmeldbeheerapplicatie 9
Ophalen meldingen (GET) Terugmeld API Gebruikers applicatie BGT, BRT, BAG & KLIC (bèta) Plaatsen meldingen (POST) BAG viewer API Frontend ( Verbeter de Kaart ) PDOK Terugmeldservices Mutatiemeldsysteem (SVB-BGT) API Terugmeldbeheerapplicatie Ophalen meldingen (GET) Updaten meldingen (PATCH) Bronhouder applicatie 10
Terugmeldingen API overzicht Gebruikers applicatie URL: /tms/v1/terugmeldingen Beveiliging: API Key GET POST API Terugmeldservices URL: tms/bronhouders/v1/terugmeldingen Beveiliging: OAUTH GET API PATCH Bronhouder applicatie 11
Uitdagingen KLIC Bij de huidige registraties in TMS wordt één terugmelding altijd geautomatiseerd aan één bronhouder gekoppeld is. Verkeerde bronhouder? Dan zet deze bronhouder de melding door naar de juiste bronhouder. Bij KLIC moet er eerst handmatig uitgezocht worden wie de bronhouder is en kunnen dit er in potentie meerdere zijn (claim proces). 12
Uitdagingen KLIC Bij de huidige registraties blijft de terugmelding actief totdat de bronhouder deze afmeld, omdat de aangepaste data is aangeleverd. Bij KLIC houdt het huidige terugmeldproces op (bij het Kadaster) wanneer de juiste netbeheerder is gevonden. 13
Demo TMS KLIC
Workshop
Workshop Requirements Groep A Hoe moet het Claim proces -voor KLIC ingericht worden Presenteren Feedback op B B Wat heeft de netbeheerder nodig om Terugmeldingen goed te kunnen afhandelen. Feedback op A Presenteren 16
17 Aantekeningen Workshop
Welkom/Samenvatting/Toelichting API Fuat Akdeniz heet iedereen welkom en verteld even kort de status van KLIC-WIN. Monique Schaafsma legt uit wat de vorige bijeenkomst is besproken en waar de focus in de Workshop op ligt. Jaap-Willem Sjoukema geeft nadere uitleg over de terugmeld API. Punten die tijdens presentaties naar voren kwamen: Systeem zodanig inrichten dat er een verschil is tussen een onbekend net of een afwijkende ligging. Een afwijkende ligging kan direct naar de netbeheerder, voor een onbekend net moet het claim proces gestart worden. Mogelijkheid om meldingen van Afwijkende Situaties toe te voegen bij de KLIC-uitlevering. Uitdaging: Hoe controleren we dat de netbeheerder wel de data heeft aanpast in zijn eigen database op basis van de Afwijkende Situatie melding. We geven de voorkeur aan, in navolging van de BAG, BGT en BRT, dat KLIC ook een status zou moeten hebben bij afgerond waarbij daadwerkelijk de data is aangepast door de netbeheerder. Proces van weesleiding bij gemeenten is niet duidelijk. Gemeenten hebben zoveel taken, KLIC is maar een heel klein onderdeel. Nieuwe gevallen oplossen door nieuwe netten goed in te meten. Dit is buiten scope van de Afwijkende Situatie API. Hieronder staat wat er in de workshop aan informatie is opgehaald. Let op: Dit zegt niets over de haalbaarheid en of het hiermee in scope is van het project. 18
Workshop groep A: Hoe moet het Claim-proces voor KLIC ingericht worden? Er zijn drie soorten meldingen: Afwijkende ligging Niet gevonden net Onbekend net Bij het niet gevonden net en afwijkende ligging is het in principe duidelijk om welke netbeheerder het gaat. Deze terugmeldingen worden direct gestuurd naar de netbeheerder die is aangegeven door de grondroerder. Deze netbeheerder kan de melding accepteren en verwerken in de tekeningen of afwijzen als verkeerde bronhouder. Bij verkeerde bronhouder zal het proces van onbekend net gaan lopen. 19
Workshop groep A: Hoe moet het Claim-proces voor KLIC ingericht worden? Algemeen: 1. Verantwoordelijkheid daar waar hij hoort: grondroerder hoort te melden en netbeheerder hoort te reageren. Netbeheerders moeten blij zijn met elke afwijkende situatie melding, zodat ze de kwaliteit van hun brondata kunnen verbeteren. 2. Kwaliteit wat is dat dan? Niet iedereen heeft het over hetzelfde. De ene heeft het over de ligging, de andere heeft het over metadata, volledigheid ed. Leg duidelijk vast en maak het meetbaar. 3. Meer analyse op de data. 1. Welke netbeheerders reageren niet binnen 10 werkdagen? (uitdaging is dat netbeheerders niet automatisch geen claim gaan inrichten.) 2. Voorkeur om in het proces data toe te voegen of er schade is veroorzaakt door afwijkende ligging. Dit kan in het schadeformulier of afwijkende situatie formulier. 4. Naar wie moet de e-mail bij de netbeheerder? Nu wordt het naar de contactpersoon in de ontvangstbevestiging gestuurd. Moeten we bijvoorbeeld in Mijn Kadaster type contactpersonen uitbreiden? Type contact Afwijkende Situatie? 5. Is er een manier te bedenken om de grondroerder te belonen met de Afwijkende Situatie melding. Kan het gestimuleerd worden? 20
Workshop groep A: Hoe moet het Claim-proces voor KLIC ingericht worden? Voorstel Agentschap Telecom: 1. In de jaarlijkse schade rapportage ook de terugmeldingen meenemen. Voorkeur om de locatie te visualiseren op een kaart van Nederland. 2. Agentschap Telecom moet netbeheerders die niet binnen 10 werkdagen reageren op een afwijkende situatie. instrueren. 21
Workshop groep A: Hoe moet het Claim-proces voor KLIC ingericht worden? Technisch/proces 1. Netbeheerder vraagt aan Kadaster via API: staan er meldingen voor de netbeheerder open? 2. Indien er een netbeheerder claimt, het claimproces afsluiten. a) De melding blijft dan open op naam van de beheerder die geclaimd heeft, totdat deze verwerkt is op de tekeningen, dan wordt de melding afgesloten. b) Uitdaging: Voorkomen dat netbeheerders eerst wachten op claim van een andere netbeheerder en daarmee erg laat reageren. c) Mogelijkheid notificeren van andere netbeheerders die betrokken zijn bij die melding indien melding geclaimd is? Er hoeft niet aangegeven te worden wie geclaimd heeft. d) Verschillende mogelijkheden om de melder op de hoogte te stellen van de status van de terugmelding: I. Via kadaster software II. Via software bij de netbeheerder die de meldingen afhandelt. 3. Welke informatie krijgt een melder terug: a) Ontvangen door het Kadaster b) In behandeling bij het Kadaster c) Geclaimd en verwerkt door de netbeheerder d) Dit kan in een extern systeem van bijvoorbeeld een werkvoorbereider kunnen. Hier zou dat ook rapportage op gemaakt kunnen worden. Deze informatie kan dan in de toekomst gedeeld worden met de grondroerders. 22
Workshop groep B: Welke informatie is nodig om melding goed te beoordelen?. Welke gegevens heb ik nodig om een Afwijkende Situatie melding End2End goed te beoordelen IMKL data meezenden, bijvoorbeeld optioneel de ID van de kabel of leiding Het verplicht maken van een BGT achtergrond + schets bij een Afwijkende ligging Bedrijfsnaam van een melder verplicht maken Optioneel mogelijk maken om op de BGT andere kaartlagen te plaatsen en dan de situatie intekenen (Bijvoorbeeld BAG) Op een afgesproken standaard of formaat de coördinaten van de ligging mee kunnen geven (GPS/XY in bijvoorbeeld GML) 23
Workshop groep B: Welke informatie is nodig om melding goed te beoordelen?. Non Functionals (Niet functioneel) C.O.B. uitnodigen voor volgende bijeenkomst De melder van een Afwijkende Situatie belonen Met meer dan 1 kanaal een Afwijkende Situatie melden: Webformulier en Tooling (via API) Opleiding verzorgen door sector: Hoe doe ik een Afwijkende Situatie Vanuit de sector of belangenorganisatie budget beschikbaar maken voor ontwikkeling tools om Afwijkende Situatie te melden Zo eenvoudig mogelijk maken om een Afwijkende Situatie te melden Er moet tooling beschikbaar komen om Afwijkende Situatie te melden 24
25 Bijlagen
26 Uitvoering POC afspraken vorige vergadering 1. Start POC: idee september 2019 (zie sheet 10) 2. Stop POC - Afspraak maken over maximale aantallen per deelnemer en maximale duur van de Pilot 3. Minimaal 2 Serviceproviders/Softwareleveranciers 4. Problemen/bevindingen melden bij klic@kadaster.nl zet in onderwerp pilot terugmelden 5. Voortgang afspraken maken