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

Handleiding

CRAB Tools Transformeren en geolocaliseren van adressen op basis van CRAB

Agentschap voor Geografische Informatie Vlaanderen


Inhoud Inhoud

2

1

Inleiding

3

1.1 Wat kan u met deze dienst doen?

3

Operaties en datatypes

4

2.1 Overzicht

4

2.2 GetCRABMatch

4

2

2.2.1 request

4

2.2.2 response

5

2.2.3 Toelichting bij de interpretatie

7

2.2.4 Fouten

8

2.3 GetAddressLocation

3

8

2.3.1 request

8

2.3.2 response

9

2.3.3 Kwaliteit van de positiebepaling

9

2.4 GetStreetLocation

10

2.4.1 request

10

2.4.2 response

10

2.4.3 Kwaliteit van de positiebepaling

10

Implementatie

2 / 11

11

Handleiding CRABTools


1 1.1

Inleiding 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.


3 / 11


2 2.1

Operaties en datatypes 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 2.2.1

GetCRABMatch request Aan de operatie GetCRABMatch wordt een meegegeven als parameter.

Figuur 1:het element ELEMENT

OMSCHRIJVING

BoxNumber

Bevat het huisnummertoevoegsel. In rijksregistertermen is dit het busnummer.

CityName

Bevat de naam van de gemeente.

HouseNumber

Bevat het huisnummer.

NisCityCode

Bevat de NIS code van de gemeente.

PostalCode

Bevat de postcode van het adres.

4 / 11



ELEMENT

OMSCHRIJVING

RrStreetCode

Bevat de straatcode zoals toegekend door het rijksregister.

Streetname

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. 2.2.2

response De operatie GetCRABMatch geeft een <MatchResponse> element terug.

Figuur 2: het <MatchResponse> element

ELEMENT

OMSCHRIJVING

MatchFound

Duidt aan of er minimaal één overeenkomstig CRAB adres is gevonden.

Faults

Bevat een lijst van fouten die gevonden werden in de request.

StreetnameId

Bevat de CRAB straatcode van het gevonden CRAB adres.

StreetnameDetail

Bevat de kenmerken van de gevonden straatnaam.

HouseNumberId

Bevat het CRAB huisnummerid van het gevonden CRAB adres (indien tot dit niveau opgelost).

HouseNumberDetail

Bevat de kenmerken van het gevonden huisnummer.

SubAddressId

Bevat het CRAB subadresid van het gevonden CRAB adres (indien tot dit niveau opgelost).

SubAddressDetail

Bevat de kenmerken van het gevonden subadres.


5 / 11


Figuur 3: het <StreetnameDetail> element ELEMENT

OMSCHRIJVING

CityNISCode

Bevat de code van de gemeente waartoe de straatnaam behoort zoals bekend bij het NIS.

CityName

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.

Name1

Bevat de straatnaam in de taal zoals aangegeven in het element . Bevat de taal van de straatnaam in de eerste taal. Mogelijke waarden zijn:

Language1

Name2

  

Dutch French German

Bevat de straatnaam in de taal zoals aangegeven in het element , 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 element

6 / 11



ELEMENT

OMSCHRIJVING

HouseNumber

Bevat de huisnummernotatie van het gevonden adres.

ZipCode

Bevat de code van het postkanton waartoe het adres behoort.

Figuur 5: het <SubAddressDetail> element ELEMENT

OMSCHRIJVING

SubAddress

Bevat de subadresnotatie van het gevonden adres. Bevat het type subadres. Mogelijke waarden zijn:

Type

2.2.3

   

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.


7 / 11


2.2.4

2.3 2.3.1

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

OMSCHRIJVING

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

11

Bisnummer niet in huisnummer maar in toevoegsel: niet-numeriek bisnummer in

12

Adrescomplement interpreteerbaar

13

Geen overeenkomst tussen postcode en gemeentenaam: verwijzen niet naar eenzelfde gemeente

14

Geen overeenkomst tussen postcode en NIS gemeentecode: verwijzen niet naar eenzelfde gemeente

niet

interpreteerbaar:

niet

leeg,

maar

niet

GetAddressLocation request Aan de operatie GetAddressLocation wordt een 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



2.3.2

response De operatie GetAddressLocation geeft een element terug.

Figuur 6: het element

ELEMENT

OMSCHRIJVING

Bbox

Bevat de omschrijvende rechthoek van het (de) geografische object(en) waarnaar de locatie verwijst.

Centroid

Bevat het zwaartepunt van het (de) geografische object(en) waarnaar de locatie verwijst.

IdExists

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. 2.3.3

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.


9 / 11


2.4

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.

6

Positie bepaald op basis van koppeling aan meerdere kadastrale percelen. De positie is de interpolatie tussen de respectievelijke centroïdes.

7

Positie bepaald op basis van interpolatie tussen de centroïdes van twee GRB gebouwen gekoppeld aan nevenliggende huisnummers.

8

Positie bepaald op basis van interpolatie tussen de centroïdes van twee GRB percelen gekoppeld aan nevenliggende huisnummers.

9

Positie bepaald op basis van interpolatie tussen de centroïdes van twee kadastrale percelen gekoppeld aan nevenliggende huisnummers.

10

Positie bepaald op basis van interpolatie tussen begin- en eindknoop van een gekoppeld wegsegment met aanwezige nummeringsinformatie.

11

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.

GetStreetLocation

2.4.1

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.

2.4.2

response De operatie GetStreetLocation geeft een element terug. Zie §2.3.2 voor een beschrijving.

2.4.3

Kwaliteit van de positiebepaling NIVEAU

KWALITEIT

11

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



3

Implementatie De CRAB Tools service kan met deze URL worden geraadpleegd: http://crab.agiv.be/toolsopen/crabtools.svc De beschrijving van deze web service (het WSDL-bestand) kan als volgt worden bekomen: http://crab.agiv.be/toolsopen/crabtools.svc?wsdl


11 / 11

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

Recommend Documents