Handleiding CRAB Edit Transacties op Lite CRAB Agentschap voor Geografische Informatie Vlaanderen Agentschap voor Geografische Informatie Vlaanderen Inhoud Inhoud 2 1 Inleiding 4 2 Operaties en datatypes 5 2.1 Overzicht 5 2.2 Edit operaties 5 2.2.1 Add 2.2.1.1 AddAdres 5 2.2.1.2 AddGebouw 10 2.2.1.3 AddStraat 10 2.2.1.4 AddWegverbinding 14 2.2.2 Update 14 2.2.2.1 UpdateAdres 15 2.2.2.2 UpdateSubadres 16 2.2.2.3 UpdateGebouw 18 2.2.2.4 UpdateStraat 19 2.2.2.5 UpdateWegverbinding 20 2.2.3 Delete 22 2.2.3.1 DeleteAdres 22 2.2.3.2 DeleteGebouw 22 2.2.3.3 DeleteStraat 22 2.2.3.4 DeleteWegverbinding 22 2.2.4 End 23 2.2.4.1 EndAdres 23 2.2.4.2 EndGebouw 23 2.2.4.3 EndStraat 23 2.2.4.4 EndWegverbinding 24 2.2.5 Hulpmethoden 24 2.2.5.1 GetGemeenteOmtrek 24 2.2.5.2 PerformRenumbering 24 2.2.6 Topologieregels 25 2.2.6.1 Gebouwen 25 2.2.6.2 Wegverbindingen 26 2.3 Verdachte gevallen 26 2.3.1 ListVerdachteGevallenQueries 26 2.3.2 CountVerdachteGevallenByQueryId 27 2.3.3 ListVerdachteGevallenByQueryId 27 2.3.4 ListVerdachteGevallenByQueryIdPaged 28 2.3.5 MaskVerdachteGevallen 29 2.4 Rapportering transacties 2 / 37 5 30 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen 2.4.1 ListBeheerdersByGemeente 30 2.4.2 ListTransacties 30 2.4.3 ListTransactiesPaged 32 2.4.4 ListTransactieAggregaten 32 2.5 Fouten 3 34 2.5.1 Validatiefouten 34 2.5.2 Onverwachte fouten 36 Implementatie 37 Handleiding CRABTools 3 / 37 Agentschap voor Geografische Informatie Vlaanderen 1 Inleiding De CRAB Edit service biedt transactionele operaties aan op de Lite CRAB entiteiten. De transacties gebeuren rechtstreeks op de beheerdatabank. De gebruiker is uiteraard beperkt tot het eigen grondgebied. 4 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen 2 2.1 Operaties en datatypes Overzicht Voor elke editeerbare entiteit zijn volgende operaties beschikbaar: Add: toevoegen van nieuwe exemplaren; Update: corrigeren van bestaande exemplaren; Delete: verwijderen van foutieve exemplaren; End: beëindigen van afgeschafte exemplaren. Naast de vier genoemde types operaties is er nog de volgende transactionele operatie: • PerformRenumbering: een operatie waarmee in één beweging meerdere adressen in een straat kunnen overgebracht worden naar een andere straat. Er is ook een operatie die de gemeentegeometrie ontsluit die intern gebruikt wordt voor validatie van transacties op geometrische data: • GetGemeenteOmtrek: deze operatie retourneert de gemeentegrens in Well-Known Text formaat. De CRAB Edit service biedt ook nog een API om met zogeheten verdachte gevallen om te gaan. Dit zijn gegevens waarvoor de datakwaliteitscontrole geen groen licht geeft en die moeten bekeken, dan wel opgelost worden door de gemeentelijke beheerder. De betreffende operaties zijn: • • • • ListVerdachteGevallenQueries: het oplijsten van de soorten verdachte gevallen; CountVerdachteGevallenByQueryId: het aantal verdachte gevallen van een bepaalde soort in de gemeente van de gebruiker; ListVerdachteGevallenByQueryId: een oplijsting van de verdachte gevallen van een bepaalde soort in de gemeente van de gebruiker; MaskVerdachteGevallen: een operatie om verdachte gevallen van de categorie 'verdacht' af te vinken. Een derde onderdeel van de CRAB Edit service API betreft de rapportering over transacties. Daartoe zijn volgende operaties voorzien: • • • • ListBeheerdersByGemeente: het oplijsten van de beheerders van de gemeente waartoe de gebruiker behoort; ListTransacties: het oplijsten van transacties die door de gemeente zijn gebeurd; ListTransactiesPaged: idem als vorige maar dan met paging; ListTransactieAggregaten: het oplijsten van kengetallen gegroepeerd per type transactie en entiteittype. In wat volgt worden de operaties en hun response en request parameters nader toegelicht. 2.2 2.2.1 2.2.1.1 Edit operaties Add AddAdres request Aan de operatie AddAdres wordt een <AddAdresRequest> element meegegeven als parameter. Handleiding CRABTools 5 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Gemeente [verplicht] Bevat de Nederlandstalige naam van de gemeente. Postcode [verplicht] Bevat de postcode die gekoppeld is aan het huisnummer. Straatnaam [verplicht] Bevat de Nederlandstalige naam van de straat. Enkel bestaande straatnamen zijn toegelaten. Huisnummer [verplicht] Bevat het nieuw toe te voegen huisnummer. Moet voldoen aan het formaat ^[1-9][0-9]*(BIS|Bis|bis|TER|Ter|ter|[a-zA-Z]|_[0-9]+){0,1}$|^ZN$|^zn$. Is maximaal 11 karakters lang. Mag nog niet bestaan in de opgegeven straatnaam. 6 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Status [verplicht] Bevat de status van het huisnummer. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop het huisnummer administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Subadressen [optioneel] Bevat de subadressen die aan het huisnummer gekoppeld zijn. RrAdres [optioneel] Bevat het (bestaand of nieuw) rijksregisteradres dat aan het huisnummer gekoppeld is. Posities [verplicht] Bevat één of meerdere posities op het terrein die aangeven waar het huisnummer gelegen is. Elke positie dient uniek te zijn qua attribuut herkomst. Huisnummers met status ‘in gebruik’ kunnen enkel dan posities hebben met herkomst ‘afgeleidVanGebouw’, ‘manueleAanduidingVanGebouw’ of ‘manueleAanduidingVanIngangVanGebouw’ wanneer er ook een koppeling is met een gebouw. Huisnummers met status ‘in gebruik’ kunnen enkel dan posities hebben met herkomst ‘afgeleidVanPerceelKadaster’ of ‘’manueleAanduidingVanPerceel’ wanneer er ook een koppeling is met een perceel. BestaandePercelen [optioneel] Bevat de bestaande percelen die aan het huisnummer gekoppeld zijn. BestaandeGebouw [optioneel] Bevat de gebouwen die aan het huisnummer gekoppeld zijn. NieuweGebouwen [optioneel] Bevat de nieuw toe te voegen gebouwen die aan het huisnummer gekoppeld zijn. ELEMENT OMSCHRIJVING Busnummer/Appnummer [verplicht] Bevat de aanduiding van het subadres. Dit is ofwel een busnummer, ofwel een appartementsnummer. Een van beide dient verplicht ingevuld te worden. Is maximaal 35 karakters lang. Handleiding CRABTools 7 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Positie [verplicht] Bevat de positie op het terrein die aangeeft waar het subadres gelegen is. Status [verplicht] Bevat de status van het subadres. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop het subadres administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Merk op dat de opgegeven datum kan verschillen van die van het huisnummer waartoe het subadres behoort, maar nooit kleiner kan zijn dan deze. RrIndex [optioneel] Bevat de indexaanduiding van het rijksregisteradres dat aan het subadres gekoppeld is. Als aanduiding van het rrhuisnummer wordt de waarde overgenomen van het huisnummer waartoe het subadres behoort. Is maximaal vier karakters lang. ELEMENT OMSCHRIJVING RrHuisnummer [verplicht] Bevat de huisnummeraanduiding van het rijksregisteradres dat aan ht huisnummer gekoppeld is. Is maximaal 11 karakters lang. RrIndex [optioneel] Bevat de indexaanduiding van het rijksregisteradres dat aan het huisnummer gekoppeld is. Is maximaal vier karakters lang. RrStraat [verplicht] Bevat de rijksregisterstraat. Enkel bestaande zijn toegelaten. ELEMENT OMSCHRIJVING RrStraatcode [verplicht] Bevat de code voor de straat zoals toegekend in het rijksregister. Bestaat uit vier cijfers. Subkantoncode [verplicht] Bevat een viercijferige code die – behoudens een paar uitzonderingen – overeenkomt met de postcode waartoe de rijksregisterstraat behoort. 8 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Herkomst [verplicht] Bevat een aanduiding voor het soort adrespositie. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Wkt [verplicht] Bevat de geometrie van de adrespositie in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type ‘Point’ zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen. ELEMENT OMSCHRIJVING Capakey [verplicht] Bevat de unieke identificator van het perceel. Enkel bestaande percelen zijn toegelaten. ELEMENT OMSCHRIJVING Identificator [verplicht] Bevat de unieke identificator van het gebouw zoals gekend in CRAB. Enkel bestaande gebouwen zijn toegelaten. Handleiding CRABTools 9 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING AardGebouw [verplicht] Bevat de aard van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop het gebouw administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Geometriemethode [verplicht] Bevat de methode waarmee de geometrie van het gebouw is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode ‘grb’ is echter niet toegelaten daar deze voorbehouden is voor AGIV. Status [verplicht] Bevat de status van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Wkt [verplicht] Bevat de geometrie van het gebouw in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type ‘Polygon’ zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van het gebouw ‘in gebruik’ is. response De operatie AddAdres geeft een <AddAdresResponse> element terug. Dit bevat het id van het nieuw toegevoegde adres. 2.2.1.2 AddGebouw request Aan de operatie AddGebouw wordt een <AddGebouwRequest> element meegegeven als parameter. response De operatie AddGebouw geeft een <AddGebouwResponse> element terug. Dit bevat het id van het nieuw toegevoegde gebouw. 2.2.1.3 AddStraat request 10 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen Aan de operatie AddStraat wordt een <AddStraatRequest> element meegegeven als parameter. ELEMENT OMSCHRIJVING Gemeente [verplicht] Bevat de Nederlandstalige naam van de gemeente. Straatnaam [verplicht] Bevat de Nederlandstalige naam van de straat. Is maximaal 80 karakters lang. Mag nog niet bestaan in de opgegeven gemeente. Straatnaam2 [optioneel] Bevat de anderstalige naam van de straat. Is maximaal 80 karakters lang. Status [verplicht] Bevat de status van de straatnaam. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop de straatnaam administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. RrStraten [optioneel] Bevat de (bestaande of nieuwe) rijksregisterstraten die aan de straat gekoppeld zijn. Wegkanten [optioneel] Bevat de (bestaande of nieuwe) wegverbindingen die aan de straat gekoppeld zijn en informatie specifiek voor die koppelingen. Handleiding CRABTools 11 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Links [verplicht] Bevat een indicatie of de straat gekoppeld is aan de linkerkant van de wegverbinding. PariteitLinks [optioneel] Bevat de aanduiding van de pariteit aan de linkerkant van de wegverbinding. De toegelaten pariteiten worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. EersteHuisnummerLinks [optioneel] Bevat een aanduiding van het eerste huisnummer aan de linkerkant van de wegverbinding. LaatsteHuisnummerLinks [optioneel] Bevat een aanduiding van het laatste huisnummer aan de linkerkant van de wegverbinding. Rechts [verplicht] Bevat een indicatie of de straat gekoppeld is aan de rechterkant van de wegverbinding. PariteitRechts [optioneel] Bevat de aanduiding van de pariteit aan de rechterkant van de wegverbinding. De toegelaten pariteiten worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. EersteHuisnummerRechts [optioneel] Bevat een aanduiding van het eerste huisnummer aan de rechterkant van de wegverbinding. LaatsteHuisnummerRechts [optioneel] Bevat een aanduiding van het laatste huisnummer aan de rechterkant van de wegverbinding. 12 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Wegverbinding [verplicht] Bevat een nieuwe of een bestaande wegverbinding. ELEMENT OMSCHRIJVING Identificator [verplicht] Bevat de unieke identificator van de wegverbinding zoals gekend in CRAB. Enkel bestaande wegverbindingen zijn toegelaten. ELEMENT OMSCHRIJVING Geometriemethode [verplicht] Bevat de methode waarmee de geometrie van de wegverbinding is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode ‘grb’ is echter niet toegelaten daar deze voorbehouden is voor AGIV. Morfologie [verplicht] Bevat een aanduiding van de morfologie van de wegverbinding. De toegelaten morfologiën worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Handleiding CRABTools 13 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Verharding [verplicht] Bevat een aanduiding de verharding van de wegverbinding. De toegelaten verhardingen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Wkt [verplicht] Bevat de geometrie van de wegverbinding in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type ‘LineString’ zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van de wegverbinding ‘in gebruik’ is. Begindatum [verplicht] [verplicht] Bevat de datum waarop de wegverbinding administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Status [verplicht] Bevat de status van de wegverbinding. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. response De operatie AddStraat geeft een <AddStraatResponse> element terug. Dit bevat het id van de nieuw toegevoegde straat. 2.2.1.4 AddWegverbinding request Aan de operatie AddWegverbinding meegegeven als parameter. wordt een <AddWegverbindingRequest> element response De operatie AddWegverbinding geeft een <AddWegverbindingResponse> element terug. Deze bevat het id van de nieuw toegevoegde wegverbinding. 2.2.2 Update In het CRAB wordt een onderscheid gemaakt tussen correcties en wijzigingen. In het eerste geval gaat het om een rechtzetting van een fout (bv. ‘Van Eikstraat’ moet zijn ‘Van Eyckstraat’), in het tweede geval gaat het om een verandering in administratieve toestand (bv. gebouw veranderd van status ‘in aanbouw’ naar ‘in gebruik’). In geval van wijziging van identificerende attributen wordt een nieuw id toegekend. De datum die wordt opgegeven voor het attrribuut begindatum wordt gebruikt als wijzigingsdatum. 14 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen 2.2.2.1 UpdateAdres request Aan de operatie UpdateAdres wordt een <UpdateAdresRequest> element meegegeven als parameter. ELEMENT OMSCHRIJVING Id [verplicht] Bevat het id van het huisnummer. IsCorrectie [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. Postcode [verplicht] Bevat de postcode die gekoppeld is aan het huisnummer. Handleiding CRABTools 15 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Huisnummer [verplicht] Bevat het huisnummer. Moet voldoen aan het formaat ^[1-9][09]*(BIS|Bis|bis|TER|Ter|ter|[a-zA-Z]|_[0-9]+){0,1}$|^ZN$|^zn$. Is maximaal 11 karakters lang. Status [verplicht] Bevat de status van het huisnummer. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop het huisnummer administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Subadressen [optioneel] Bevat de subadressen die aan het huisnummer gekoppeld zijn. RrAdres [optioneel] Bevat het (bestaand of nieuw) rijksregisteradres dat aan het huisnummer gekoppeld is. Posities [verplicht] Bevat één of meerdere posities op het terrein die aangeven waar het huisnummer gelegen is. Elke positie dient uniek te zijn qua attribuut herkomst. Huisnummers met status ‘in gebruik’ kunnen enkel dan posities hebben met herkomst ‘afgeleidVanGebouw’, ‘manueleAanduidingVanGebouw’ of ‘manueleAanduidingVanIngangVanGebouw’ wanneer er ook een koppeling is met een gebouw. Huisnummers met status ‘in gebruik’ kunnen enkel dan posities hebben met herkomst ‘afgeleidVanPerceelKadaster’ of ‘’manueleAanduidingVanPerceel’ wanneer er ook een koppeling is met een perceel. BestaandePercelen [optioneel] Bevat de bestaande percelen die aan het huisnummer gekoppeld zijn. BestaandeGebouw [optioneel] Bevat de gebouwen die aan het huisnummer gekoppeld zijn. NieuweGebouwen [optioneel] Bevat de nieuw toe te voegen gebouwen die aan het huisnummer gekoppeld zijn. response De operatie UpdateAdres geeft een <UpdateAdresResponse> element terug. Dit bevat het id van het gecorrigeerde of gewijzigde huisnummer. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de request werd meegegeven. 2.2.2.2 UpdateSubadres request Aan de operatie UpdateSubadres wordt een <UpdateSubadresRequest> element meegegeven als parameter. 16 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Id [verplicht] Bevat het id van het subadres. IsCorrectie [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. Busnummer/Appnummer [verplicht] Bevat de aanduiding van het subadres. Dit is ofwel een busnummer, ofwel een appartementsnummer. Een van beide dient verplicht ingevuld te worden. Is maximaal 35 karakters lang. Status [verplicht] Bevat de status van het subadres. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop het subadres administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. RrAdres [optioneel] Bevat het (bestaand of nieuw) rijksregisteradres dat aan het subadres gekoppeld is. Posities [verplicht] Bevat één of meerdere posities op het terrein die aangeven waar het subadres gelegen is. Elke positie dient uniek te zijn qua attribuut herkomst. response De operatie UpdateSubadres geeft een <UpdateSubadresResponse> element terug. Handleiding CRABTools 17 / 37 Agentschap voor Geografische Informatie Vlaanderen Dit bevat het id van het gecorrigeerde of gewijzigde subadres. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de request werd meegegeven. 2.2.2.3 UpdateGebouw request Aan de operatie UpdateGebouw wordt een <UpdateGebouwRequest> element meegegeven als parameter. ELEMENT OMSCHRIJVING Id [verplicht] Bevat het id van het gebouw. IsCorrectie [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. AardGebouw [verplicht] Bevat de aard van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop het gebouw administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Geometriemethode [verplicht] Bevat de methode waarmee de geometrie van het gebouw is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode ‘grb’ is echter niet toegelaten daar deze voorbehouden is voor AGIV. 18 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Status [verplicht] Bevat de status van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Wkt [verplicht] Bevat de geometrie van het gebouw in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type ‘Polygon’ zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van het gebouw ‘in gebruik’ is. response De operatie UpdateGebouw geeft een <UpdateGebouwResponse> element terug. Dit bevat het id van het gecorrigeerde of gewijzigde gebouw. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de request werd meegegeven. 2.2.2.4 UpdateStraat request Aan de operatie UpdateStraat wordt een <UpdateStraatRequest> element meegegeven als parameter. Handleiding CRABTools 19 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Id [verplicht] Bevat het id van de straat. IsCorrectie [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. Straatnaam [verplicht] Bevat de Nederlandstalige naam van de straat. Is maximaal 80 karakters lang. Mag nog niet bestaan in de opgegeven gemeente. Straatnaam2 [optioneel] Bevat de anderstalige naam van de straat. Is maximaal 80 karakters lang. Status [verplicht] Bevat de status van de straatnaam. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Begindatum [verplicht] Bevat de datum waarop de straatnaam administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. RrStraten [optioneel] Bevat de (bestaande of nieuwe) rijksregisterstraten die aan de straat gekoppeld zijn. Wegkanten [optioneel] Bevat de (bestaande of nieuwe) wegverbindingen die aan de straat gekoppeld zijn en informatie specifiek voor die koppelingen. response De operatie UpdateStraat geeft een <UpdateStraatResponse> element terug. Dit bevat het id van de gecorrigeerde of gewijzigde straat. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de request werd meegegeven. 2.2.2.5 UpdateWegverbinding request Aan de operatie UpdateWegverbinding wordt een <UpdateWegverbindingRequest> element meegegeven als parameter. 20 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Id [verplicht] Bevat het id van de wegverbinding. IsCorrectie [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. Geometriemethode [verplicht] Bevat de methode waarmee de geometrie van de wegverbinding is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode ‘grb’ is echter niet toegelaten daar deze voorbehouden is voor AGIV. Morfologie [verplicht] Bevat een aanduiding van de morfologie van de wegverbinding. De toegelaten morfologiën worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Verharding [verplicht] Bevat een aanduiding de verharding van de wegverbinding. De toegelaten verhardingen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Wkt [verplicht] Bevat de geometrie van de wegverbinding in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type ‘LineString’ zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van de wegverbinding ‘in gebruik’ is. Begindatum [verplicht] [verplicht] Bevat de datum waarop de wegverbinding administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Handleiding CRABTools 21 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Status [verplicht] Bevat de status van de wegverbinding. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. response De operatie UpdateWegverbinding geeft een <UpdateWegverbindingResponse> element terug. Dit bevat het id van de gecorrigeerde of gewijzigde wegverbinding. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de request werd meegegeven. 2.2.3 2.2.3.1 Delete In het CRAB wordt een onderscheid gemaakt tussen correcties en wijzigingen. In het eerste geval gaat het om een rechtzetting van een fout (bv. straatnaam ‘Van Eikstraat’ bestaat niet), in het tweede geval gaat het om een verandering in administratieve toestand (bv. straatnaam is administratief afgeschaft). De delete operaties betreffen het eerste geval. DeleteAdres request Aan de operatie DeleteAdres wordt het id van het te verwijderen adres meegegeven als parameter. response De operatie DeleteAdres geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.3.2 DeleteGebouw request Aan de operatie DeleteGebouw wordt het id van het te verwijderen gebouw meegegeven als parameter. response De operatie DeleteGebouw geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.3.3 DeleteStraat request Aan de operatie DeleteStraat wordt het id van de te verwijderen straat meegegeven als parameter. response De operatie DeleteStraat geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.3.4 DeleteWegverbinding request 22 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen Aan de operatie DeleteWegverbinding wordt het id van de te verwijderen wegverbinding meegegeven als parameter. response De operatie DeleteWegverbinding geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.4 End In het CRAB wordt een onderscheid gemaakt tussen correcties en wijzigingen. In het eerste geval gaat het om een rechtzetting van een fout (bv. straatnaam ‘Van Eikstraat’ bestaat niet), in het tweede geval gaat het om een verandering in administratieve toestand (bv. straatnaam is administratief afgeschaft). De end operaties betreffen het tweede geval, de zogeheten historeringen. De datum die als request parameter wordt meegegeven aan de operaties geldt als einddatum van het exemplaar en diens afhangende objecten. 2.2.4.1 EndAdres request Aan de operatie EndAdres worden de volgende parameters meegegeven: response De operatie EndAdres geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.4.2 EndGebouw request Aan de operatie EndGebouw worden de volgende parameters meegegeven: response De operatie EndGebouw geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.4.3 EndStraat request Aan de operatie EndStraat worden de volgende parameters meegegeven: Handleiding CRABTools 23 / 37 Agentschap voor Geografische Informatie Vlaanderen response De operatie EndStraat geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.4.4 EndWegverbinding request Aan de operatie EndWegverbinding worden de volgende parameters meegegeven: response De operatie EndWegverbinding geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. 2.2.5 2.2.5.1 Hulpmethoden GetGemeenteOmtrek request Aan de operatie GetGemeenteOmtrek wordt de Nederlandstalige naam van de gemeente meegegeven als parameter. response De operatie GetGemeenteOmtrek geeft een <GetGemeenteOmtrekResponse> element terug. Het resultaat bevat de geometrie van de gemeentegrens in Well-Known Text formaat in Lambert72 projectie (EPSG 31370). 2.2.5.2 PerformRenumbering request Aan de operatie PerformRenumbering wordt een <RenumberingRequest> element meegegeven als parameter. 24 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING Datum [verplicht] Bevat de datum waarop het hernummering administratief plaats heeft gevonden. Deze datum wordt gebruikt als begindatum voor de nieuwe exemplaren en (datum – 1) als einddatum van de te historeren exemplaren. EndOldAddresses [verplicht] Duidt aan of de huisnummers die niet worden herbruikt moeten gehistoreerd worden dan wel de status ‘buiten gebruik’ krijgen. RenumberingLines [verplicht] Bevat de mapping van oude huisnummers op nieuwe huisnummers. ELEMENT OMSCHRIJVING AdresId [verplicht] Bevat het id van het bronhuisnummer. Huisnummer [verplicht] Bevat het (nieuwe of bestaande) doelhuisnummer. Indien nieuw dient het te voldoen aan het formaat ^[1-9][0-9]*(BIS|Bis|bis|TER|Ter|ter|[a-zA-Z]|_[09]+){0,1}$|^ZN$|^zn$. Mag maximum 11 karakters lang zijn. Straatnaam [verplicht] Bevat de naam van de bestaande straat. response De operatie PerformRenumbering geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. Merk op dat deze operatie lang kan duren. Alnaargelang de configuratie van de proxy of stub kan het zijn dat je een TimeOutException krijgt terwijl de uitvoering van de operatie eigenlijk nog bezig is. 2.2.6 2.2.6.1 Topologieregels Gebouwen • geen self-intersection • geen overlap met andere gebouwen • geen overlap met wegverbindingen • minimale oppervlakte 10m² Handleiding CRABTools 25 / 37 Agentschap voor Geografische Informatie Vlaanderen • 2.2.6.2 2.3 2.3.1 maximale oppervlakte 50 000m² Wegverbindingen • geen self-intersection • geen overlap met andere wegverbindingen • geen overlap met gebouwen • geen undershoot binnen een tolerantie van 1m • minimale lengte 5m • maximale lengte 5000m Verdachte gevallen ListVerdachteGevallenQueries request De operatie ListVerdachteGevallenQueries wordt aangeroepen zonder parameters. response De operatie ListVerdachteGevallenQueries <ListVerdachteGevallenQueriesResponse> element terug. geeft een ELEMENT OMSCHRIJVING QueryId Het interne id van het type verdacht geval. EntiteitType Het soort Lite CRAB entiteit (adres, gebouw, perceel, straat of wegverbinding). ValidatieType Het categorie waartoe het type verdacht geval behoort (foutief, verdacht, verbeterbaar). Omschrijving Een korte omschrijving van het type verdacht geval. 26 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen 2.3.2 ELEMENT OMSCHRIJVING Instructie Een beschrijving van hoe het type verdacht geval kan opgelost worden. LabelHoofding De naam van de Lite CRAB entiteit. CountVerdachteGevallenByQueryId request Aan de operatie meegegeven: CountVerdachteGevallenByQueryId worden de volgende parameters ELEMENT OMSCHRIJVING queryId Het interne id van het type verdacht geval. gemeente De Nederlandstalige naam van de gemeente waarvoor de lijst van verdachte gevallen moet opgesteld worden. response De operatie CountVerdachteGevallenByQueryId <CountVerdachteGevallenByQueryIdResponse> element terug. geeft een Dit bevat het aantal verdachte gevallen van het opgegeven type in de opgegeven gemeente. Merk op dat voor een aantal grotere gemeenten het oplijsten van bepaalde types van verdachte gevallen lang kan duren. De operatie krijgt maximaal 50 seconden te tijd om een lijst te produceren, zoniet wordt als resultaat -1 gegeven. 2.3.3 ListVerdachteGevallenByQueryId request Aan de operatie ListVerdachteGevallenByQueryId worden de volgende parameters meegegeven: ELEMENT OMSCHRIJVING queryId Het interne id van het type verdacht geval. Handleiding CRABTools 27 / 37 Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING gemeente De Nederlandstalige naam van de gemeente waarvoor de lijst van verdachte gevallen moet opgesteld worden. response De operatie ListVerdachteGevallenByQueryId <ListVerdachteGevallenByQueryIdResponse> element terug. 2.3.4 geeft ELEMENT OMSCHRIJVING EntiteitId Het id van het Lite CRAB exemplaar. Label Een UI vriendelijke kenmerkende tekst voor het exemplaar. VolgNummer Een betekenisloos volgnummer bedoeld voor lijsten in UI (niet idempotent). een ListVerdachteGevallenByQueryIdPaged request Aan de operatie ListVerdachteGevallenByQueryIdPaged worden de volgende parameters meegegeven: ELEMENT 28 / 37 OMSCHRIJVING Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING queryId Het interne id van het type verdacht geval. gemeente De Nederlandstalige naam van de gemeente waarvoor de lijst van verdachte gevallen moet opgesteld worden. pageSize Het aantal elementen per logische pagina. pageIndex Het volgnummer van de logische pagina. response De operatie ListVerdachteGevallenByQueryIdPaged <ListVerdachteGevallenByQueryIdPagedResponse> element terug. geeft een Het attribuut TotaalAantalGevallen bevat het aantal verdachte gevallen van het opgegeven type in de opgegeven gemeente. 2.3.5 MaskVerdachteGevallen request Aan de operatie MaskVerdachteGevallen wordt een <MaskRequest> element meegegeven als parameter. ELEMENT OMSCHRIJVING EntiteitIds Een collectie van id’s van Lite CRAB exemplaren. Enkel exemplaren die tot het grondgebied van de aanroepende gemeente behoren worden aanvaard. QueryId Het interne id van het type verdacht geval. Merk op dat verdachte gevallen van het type ‘foutief’ niet maskeerbaar zijn. response De operatie MaskVerdachteGevallen geeft geen response terug. Als er geen fout komt als antwoord op de request, dan mag de operatie als geslaagd worden beschouwd. Handleiding CRABTools 29 / 37 Agentschap voor Geografische Informatie Vlaanderen 2.4 2.4.1 Rapportering transacties ListBeheerdersByGemeente request De operatie ListBeheerdersByGemeente wordt aangeroepen zonder parameters. Merk op dat de lijst van beheerders gefilterd wordt op de gemeente van de aanroeper van de operatie. response De operatie ListBeheerdersByGemeente geeft een <ListBeheerdesByGemeenteResponse> element terug. 2.4.2 ELEMENT OMSCHRIJVING Gemeente De Nederlandstalige naam van de gemeente. Name De gebruikersnaam van de beheerder. ListTransacties request Aan de operatie ListTransacties worden de volgende parameters meegegeven: ELEMENT OMSCHRIJVING gemeente De Nederlandstalige naam van de gemeente. beheerder De gebruikersnaam van de beheerder. 30 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING tijdstip1 Bevat de start van de periode waarover gerapporteerd wordt. tijdstip2 Bevat het einde van de periode waarover gerapporteerd wordt. response De operatie ListTransacties geeft een <ListTransactiesResponse> element terug. ELEMENT OMSCHRIJVING Beheerder De gebruikersnaam van de beheerder. Beschrijving Een opsomming van wat er in de transactie allemaal gebeurd is. CrabEntiteitType Het soort Lite CRAB entiteit (adres, gebouw, perceel, straat of wegverbinding). EntiteitId Het id van het Lite CRAB exemplaar waarop de transactie betrekking heeft. Merk op dat het id mogelijks niet meer bestaat. Tijdstip Het tijdstip waarop de transactie heeft plaatsgevonden. TransactieType Het soort transactie Hernummering) Volgnummer Een betekenisloos volgnummer. Handleiding CRABTools (Invoer, Correctie, Historering, Verwijdering, 31 / 37 Agentschap voor Geografische Informatie Vlaanderen 2.4.3 ListTransactiesPaged request Aan de operatie ListTransactiesPaged worden de volgende parameters meegegeven: ELEMENT OMSCHRIJVING gemeente De Nederlandstalige naam van de gemeente. beheerder De gebruikersnaam van de beheerder. tijdstip1 Bevat de start van de periode waarover gerapporteerd wordt. tijdstip2 Bevat het einde van de periode waarover gerapporteerd wordt. pageSize Het aantal elementen per logische pagina. pageIndex Het volgnummer van de logische pagina. response De operatie ListTransactiesPaged geeft een <ListTransactiesPagedResponse> element terug. 2.4.4 ListTransactieAggregaten request Aan de operatie ListTransactieAggregaten worden de volgende parameters meegegeven: 32 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen ELEMENT OMSCHRIJVING gemeente De Nederlandstalige naam van de gemeente. beheerder De gebruikersnaam van de beheerder. tijdstip1 Bevat de start van de periode waarover gerapporteerd wordt. tijdstip2 Bevat het einde van de periode waarover gerapporteerd wordt. response De operatie ListTransactieAggregaten element terug. geeft een <ListTransactieAggregatenResponse> ELEMENT OMSCHRIJVING CrabEntiteitType Het soort Lite CRAB entiteit (adres, gebouw, perceel, straat of wegverbinding). TransactieType Het soort transactie Hernummering) Aantal Het aantal transacties van het betreffende soort op de betreffende entiteit tijdens de opgegeven periode. Handleiding CRABTools (Invoer, Correctie, Historering, Verwijdering, 33 / 37 Agentschap voor Geografische Informatie Vlaanderen 2.5 2.5.1 Fouten Validatiefouten Fouten tegen de validatieregels leiden tot een SOAP Fault. Die bevat zowel een tag als een Nederlandstalige omschrijving. <s:Fault> <s:Code> <s:Value>s:Sender</s:Value> </s:Code> <s:Reason> <s:Text xml:lang="nl-BE">A server exception occurred.</s:Text> </s:Reason> <s:Detail> <FaultDetail xmlns="http://www.agiv.be/ErrorHandling/2010/04" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Messages> <FaultMessage> <Source>Gisvl.CrabDecentraal.Edit</Source> <Tag>GemeenteNietEditeerbaar</Tag> <Translations> <MessageText> <Culture>nl-BE</Culture> <Text>Entiteiten in de gemeente Sint-Niklaas kunnen niet worden bewerkt door de huidige gebruiker.</Text> </MessageText> </Translations> </FaultMessage> </Messages> </FaultDetail> </s:Detail> </s:Fault> De gebruikte tags en hun betekenis zijn hieronder weergegeven. De beschrijving in de validatiefout kan contextuele informatie bevatten zoals een verwijzing naar een opgegeven waarde. TAG AttribuutIngevuld CheckAll DatumOngeldig EinddatumIngevuld EinddatumOngeldig ExemplaarBestaatAl GccConstraint GebruikerNietGekoppeld 34 / 37 BETEKENIS Er mag geen waarde worden opgegeven voor het attribuut. Foute topologie. De opgegeven waarde ligt niet in het geldig bereik. Een einddatum mag niet worden opgegeven voor het element. De einddatum moet groter zijn dan de begindatum. Het opgegeven exemplaar bestaat al. Er zijn afhankelijke objecten waarvoor de opgegeven datum niet voldoet. De huidige gebruiker is niet gekoppeld aan een Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen GeenToegang GemeenteNietEditeerbaar GeometriemethodeOngeldig HerkomstNietUniek HerkomstOngeldig HuisnummerOngeldig IdBestaatNiet KantOngeldig KantOntbreekt KarakterlengteNietCorrect LijstBevatDubbels LijstwaardeOngeldig LineNoCrossing LineNoUndershoot LineTouches MaxKarakterlengteOverschreden MaxLength MaxSurface MinDatumHernummering MinLength MinSurface NoIndenticalSegments RrAdresZonderPostcode RrStraatBestaatAl RrstraatcodeOngeldig StraatcodeIngevuld Handleiding CRABTools gemeente. De gebruiker is niet bevoegd om de operatie uit te voeren. Entiteiten in de gemeente X kunnen niet worden bewerkt door de gebruiker. De geometriemethode 'grb' kan niet worden toegekend door de huidige gebruiker. Een adres kan slechts meerdere adresposities hebben indien die allen een verschillende herkomst hebben. De waarde voor herkomst is niet toegelaten zonder koppeling met een gebouw of perceel. De waarde voor het huisnummer voldoet niet aan het voorgeschreven formaat. Er bestaat geen exemplaar met het opgegeven id. De linker- en rechterpariteit kunnen niet gelijk zijn. Er moet een waarde worden opgegeven voor minstens een van de beide pariteiten. De opgegeven waarde voor moet exact X karakters tellen. De lijst met bronadressen bevat dubbels. De waarde bestaat niet voor het attribuut. Lijnen mogen niet kruisen Lijnen moet aansluiten indien dichter dan 1 m bij elkaar. Foute topologie De opgegeven waarde mag maximaal uit X karakters bestaan. De lengte is groter dan de maximale waarde De oppervlakte m² is groter dan de maximale waarde De datum voor de hernummering moet groter zijn dan X omdat er een huisnummer bij betrokken is met begindatum Y De lengte is kleiner dan de minimale waarde De oppervlakte m² is kleiner dan de minimale waarde Lijnen mogen niet overlappen Er kan geen rijksregisteradres worden opgegeven wanneer de postcode voor gerelateerde huisnummer ontbreekt. De rijksregisterstraat met code X in subkanton Y is reeds gekoppeld aan een andere straat De waarde voor de rrstraatcode voldoet niet aan het voorgeschreven formaat. Een straatcode mag niet worden opgegeven voor een nieuwe straat. 35 / 37 Agentschap voor Geografische Informatie Vlaanderen StraatnaamBestaatNiet SubadresNietEditeren Subadresnummer TemporeleOverlap VerdachtGevalNietMaskeerbaar VerplichtElementOntbreekt WijzigingsdatumOngeldig WktBuitenGemeente WktOngeldig 2.5.2 De straatnaam bestaat niet in de gemeente Het bewerken an een subadres is niet mogelijk via de aangeroepen operatie. Er moet een waarde worden opgegeven voor ofwel het busnummer ofwel het appartementsnummer. Er heeft al een exemplaar bestaan met dezelfde identificerende kenmerken. De opgegeven begindatum moet groter zijn dan X Een verdacht geval met validatietype ‘foutief’ is niet maskeerbaar. Het element is verplicht. De wijzigingsdatum moet minimaal twee dagen later zijn dan de huidige begindatum. De opgegeven geometrie ligt niet binnen de omtrek van gemeente De opgegeven WKT waarde is niet geldig Onverwachte fouten Onverwachte fouten leiden eveneens tot een SOAP Fault: <s:Fault xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility1.0.xsd" xmlns:xml="http://www.w3.org/XML/1998/namespace"> <s:Code> <s:Value>s:Sender</s:Value> </s:Code> <s:Reason> <s:Text xml:lang="">An unexpected error occurred, and error details have been logged with id 2c8e02b8-d866-485e-802d-bea211704523.</s:Text> <s:Text xml:lang="nl-BE">Er is een onverwachte fout opgetreden, en de details zijn gelogged met id 2c8e02b8-d866-485e-802d-bea211704523.</s:Text> <s:Text xml:lang="fr-BE">Une erreur imprévue s'est produite, le détail de l'erreur a été logé avec l' id 2c8e02b8-d866-485e-802d-bea211704523.</s:Text> </s:Reason> </s:Fault> 36 / 37 Handleiding CRABTools Agentschap voor Geografische Informatie Vlaanderen 3 Implementatie De CRAB Edit service kan met deze URL worden geraadpleegd: https://crab.agiv.be/edit/crabeditservice.svc De beschrijving van deze web service (het WSDL-bestand) kan als volgt worden bekomen: http://crab.agiv.be/edit/crabeditservice.svc?wsdl Handleiding CRABTools 37 / 37
© Copyright 2025 ExpyDoc