Handleiding. CRAB Tools. Transformeren en geolocaliseren van adressen op basis van CRAB. Agentschap voor Geografische Informatie Vlaanderen

Transcriptie

1 Handleiding CRAB Tools Transformeren en geolocaliseren van adressen op basis van CRAB Agentschap voor Geografische Informatie Vlaanderen

2 Inhoud Inhoud 2 1 Inleiding Wat kan u met deze dienst doen? 3 2 Operaties en datatypes Overzicht GetCRABMatch request response Toelichting bij de interpretatie Fouten GetAddressLocation request response Kwaliteit van de positiebepaling GetStreetLocation request response Kwaliteit van de positiebepaling 10 3 Implementatie 11 2 / 11 Handleiding CRABTools

3 1 Inleiding 1.1 Wat kan u met deze dienst doen? Met de CRAB Tools service kan u aan geocoding doen. Een eerste operatie laat toe om uw eigen adressen (mogelijks in rijksregisternotatie) om te zetten naar bestaande CRAB adressen. Als u een match hebt gevonden, kan u daarmee verder om met behulp van de andere operaties de positie van het adres op te vragen. De service kan ook aangewend worden om eigen adresbestanden op te schonen en te verrijken met geografische informatie. Handleiding CRABTools 3 / 11

4 2 Operaties en datatypes 2.1 Overzicht Er zijn drie operaties: GetCRABMatch: met deze operatie kan men voor een gegeven adres het overeenkomstige CRAB adres opzoeken; deze operatie is in eerste instantie bedoeld voor de omzetting van adressen in rijksregisternotatie naar CRAB adressen, maar kan uiteraard ook voor andere formaten worden aangewend; GetAddressLocation: met deze operatie kan men de (gekende of berekende) terreinpositie voor een gegeven adres bekomen; GetStreetLocation: met deze operatie kan men de positie van een gegeven straat bekomen. Door de operaties sequentieel te gebruiken kan men aan geocoding doen. In wat volgt worden de operaties en hun response en request parameters nader toegelicht. 2.2 GetCRABMatch request Aan de operatie GetCRABMatch wordt een <FormattedAddress> meegegeven als parameter. Figuur 1:het <FormattedAddress> element BoxNumber CityName HouseNumber NisCityCode PostalCode Bevat het huisnummertoevoegsel. In rijksregistertermen is dit het busnummer. Bevat de naam van de gemeente. Bevat het huisnummer. Bevat de NIS code van de gemeente. Bevat de postcode van het adres. 4 / 11 Handleiding CRABTools

5 RrStreetCode Streetname Bevat de straatcode zoals toegekend door het rijksregister. Bevat de straatnaam. Geen enkele van de invoervelden is verplicht. Geef in dat geval een lege stringwaarde mee. Uiteraard is het vinden van een overeenkomstig CRAB adres makkelijker indien de invoer gedegen informatie bevat response De operatie GetCRABMatch geeft een <MatchResponse> element terug. Figuur 2: het <MatchResponse> element MatchFound Faults StreetnameId StreetnameDetail HouseNumberId HouseNumberDetail SubAddressId SubAddressDetail Duidt aan of er minimaal één overeenkomstig CRAB adres is gevonden. Bevat een lijst van fouten die gevonden werden in de request. Bevat de CRAB straatcode van het gevonden CRAB adres. Bevat de kenmerken van de gevonden straatnaam. Bevat het CRAB huisnummerid van het gevonden CRAB adres (indien tot dit niveau opgelost). Bevat de kenmerken van het gevonden huisnummer. Bevat het CRAB subadresid van het gevonden CRAB adres (indien tot dit niveau opgelost). Bevat de kenmerken van het gevonden subadres. Handleiding CRABTools 5 / 11

6 Figuur 3: het <StreetnameDetail> element CityNISCode CityName Name1 Bevat de code van de gemeente waartoe de straatnaam behoort zoals bekend bij het NIS. Bevat de naam van de gemeente waartoe de straatnaam behoort. Als er een Nederlandstalige naam bestaat, wordt deze geretourneerd, anders de Franstalige of Duitstalige naam. Bevat de straatnaam in de taal zoals aangegeven in het element <Language1>. Bevat de taal van de straatnaam in de eerste taal. Mogelijke waarden zijn: Language1 Dutch French German Name2 Bevat de straatnaam in de taal zoals aangegeven in het element <Language2>, op voorwaarde dat de straatnaam officieel in twee talen is gekend. Bevat de taal van de straatnaam in de tweede taal. Mogelijke waarden zijn: Language2 Dutch French German Figuur 4: het <HousenumberDetail> element 6 / 11 Handleiding CRABTools

7 HouseNumber ZipCode Bevat de huisnummernotatie van het gevonden adres. Bevat de code van het postkanton waartoe het adres behoort. Figuur 5: het <SubAddressDetail> element SubAddress Bevat de subadresnotatie van het gevonden adres. Bevat het type subadres. Mogelijke waarden zijn: Type Apartment BoxNumber CadastralDescription Other Toelichting bij de interpretatie In een eerste stap wordt getracht de overeenkomstige straatnaam terug te vinden in CRAB. Pas als dat gelukt is, wordt er gekeken naar huisnummers en eventuele busnummers. Het kan zijn dat een gevonden CRAB adres enkel bestaat uit een straatnaam indien bijvoorbeeld geen huisnummerinformatie in de request werd meegegeven, of indien er geen overeenkomstig huisnummer werd gevonden in CRAB. Het antwoord kan nul, een of meerdere overeenkomstige CRAB adressen bevatten. Deze multipliciteit kan twee oorzaken hebben. Ofwel werd tijdens het zoeken naar de straatnaam geen exacte overeenstemming gevonden, maar wel een aantal gelijkende straatnamen. Het is dan aan de aanroeper om verder te bepalen welke de juiste is. Ofwel bevatte de request een zogenaamd huisnummerbereik en werd dat omgezet naar individuele huisnummers. Handleiding CRABTools 7 / 11

8 2.2.4 Fouten Tijdens de interpretatie worden een aantal controles uitgevoerd die de aanroeper van de operatie kunnen bijstaan in het opschonen van diens gegevens. Het voorkomen van een of meerdere fouten in de response betekent niet noodzakelijkerwijs dat er geen overeenkomstig CRAB adres is gevonden. FOUTCODE 1 Ongeldige NIS gemeentecode: niet numeriek 2 Onbekende NIS gemeentecode: komt niet voor in CRAB 3 Onbekende gemeentenaam: komt niet voor in CRAB 4 Geen overeenkomst tussen NIS gemeentecode en gemeentenaam: verwijzen naar verschillende gemeentes 5 Ongeldige postcode: niet numeriek 6 Onbekende postcode: komt niet voor in CRAB 7 Ongeldige rijksregisterstraatcode: niet numeriek en geen wachtcode 8 Ongeldig huisnummer: bevat de waarde 0 9 Huisnummer in straatnaam: [0-9]+ als prefix in de straatnaam 10 Huisnummer met bisnummer in straatnaam: [0-9]+[A-Z] als prefix in de straatnaam Bisnummer niet in huisnummer maar in toevoegsel: niet-numeriek bisnummer in <BoxNumber> Adrescomplement niet interpreteerbaar: <BoxNumber> niet leeg, maar niet interpreteerbaar Geen overeenkomst tussen postcode en gemeentenaam: verwijzen niet naar eenzelfde gemeente Geen overeenkomst tussen postcode en NIS gemeentecode: verwijzen niet naar eenzelfde gemeente 2.3 GetAddressLocation request Aan de operatie GetAddressLocation wordt een <housenumberid> meegegeven als parameter. Dit is de code die binnen CRAB wordt gehanteerd voor de entiteit huisnummer. Bijgevolg kunnen enkel posities worden gegeven voor ons bekende huisnummer. 8 / 11 Handleiding CRABTools

9 2.3.2 response De operatie GetAddressLocation geeft een <LocationResponse> element terug. Figuur 6: het <LocationResponse> element Bbox Centroid IdExists Bevat de omschrijvende rechthoek van het (de) geografische object(en) waarnaar de locatie verwijst. Bevat het zwaartepunt van het (de) geografische object(en) waarnaar de locatie verwijst. Duidt aan of het opgegeven id al dan niet bestaat. Merk op dat indien het niet bestaat, er ook geen locatie wordt teruggegeven. Quality Bevat een indicatie van het kwaliteitsniveau van de positiebepaling. De geometrische kenmerken worden in Lambert-72 projectie (EPSG 31370) doorgegeven Kwaliteit van de positiebepaling Er wordt getracht een zo nauwkeurig mogelijke positie te bepalen voor het gegeven huisnummer. Daarvoor zijn een aantal niveau s gedefinieerd, waarbij steeds gestart wordt op het hoogste niveau. Wordt op dat niveau geen positionele informatie gevonden, dan wordt naar een niveau lager afgezakt. Wordt ook daar geen positionele informatie gevonden, dan wordt er opnieuw gezakt. Dit gaat zo verder tot het laagste niveau is bereikt. Handleiding CRABTools 9 / 11

10 NIVEAU KWALITEIT 1 Positie bepaald op basis van koppeling aan een enkel GRB gebouw. 2 Positie bepaald op basis van koppeling aan meerdere GRB gebouwen. De positie is de interpolatie tussen de respectievelijke centroïdes. 3 Positie bepaald op basis van koppeling aan een enkel GRB perceel. 4 Positie bepaald op basis van koppeling aan meerdere GRB percelen. De positie is de interpolatie tussen de respectievelijke centroïdes. 5 Positie bepaald op basis van koppeling aan kadastraal perceel Positie bepaald op basis van koppeling aan meerdere kadastrale percelen. De positie is de interpolatie tussen de respectievelijke centroïdes. Positie bepaald op basis van interpolatie tussen de centroïdes van twee GRB gebouwen gekoppeld aan nevenliggende huisnummers. Positie bepaald op basis van interpolatie tussen de centroïdes van twee GRB percelen gekoppeld aan nevenliggende huisnummers. Positie bepaald op basis van interpolatie tussen de centroïdes van twee kadastrale percelen gekoppeld aan nevenliggende huisnummers. Positie bepaald op basis van interpolatie tussen begin- en eindknoop van een gekoppeld wegsegment met aanwezige nummeringsinformatie. Positie bepaald op basis van de centroïde van alle wegsegmenten behorend tot gekoppelde straat. 12 Positie bepaald op basis van de centroïde van de gekoppelde gemeente. 2.4 GetStreetLocation request Aan de operatie GetStreetLocation wordt een <streetnameid> meegegeven als parameter. Dit is de code die binnen CRAB wordt gehanteerd voor de entiteit straatnaam, ook wel gekend als CRAB code. Bijgevolg kunnen enkel posities worden gegeven voor ons bekende straatnamen response De operatie GetStreetLocation geeft een <LocationResponse> element terug. Zie voor een beschrijving Kwaliteit van de positiebepaling NIVEAU 11 KWALITEIT Positie bepaald op basis van de centroïde van alle wegsegmenten behorend tot gekoppelde straat. 12 Positie bepaald op basis van de centroïde van de gekoppelde gemeente. 10 / 11 Handleiding CRABTools

11 3 Implementatie De CRAB Tools service kan met deze URL worden geraadpleegd: De beschrijving van deze web service (het WSDL-bestand) kan als volgt worden bekomen: Handleiding CRABTools 11 / 11