Bent u op zoek naar de juiste methode, probeer eerst volgende vragen te beantwoorden:

• Wil ik een exacte opzoeking doen of mag dit ‘fuzzy’ zijn? Bij een fuzzy opzoeking wordt beter omgegaan met typfouten en onvolledigheden.
• Wil ik het adres ongestructureerd in 1 keer ingeven of als aparte velden (straatnaam, huisnummer, gemeente...)?
  • Het adres in 1 keer ingeven wordt typisch gebruikt in ‘autocomplete’-velden, waarbij suggesties worden getoond op basis van het al ingetypte deel van het adres.
• Wil ik in het resultaat ook adressen met busnummers?
• Wil ik in het resultaat ook de coördinaat van het adres of wil ik kunnen zoeken op coördinaten?
• Wil ik ook adressen in Brussel en Wallonië opzoeken? Gebruik dan de BestAdd-services(opent in nieuw venster).

Zoek een adres via fuzzy matching aan de hand van volgende parameters:

• gemeentenaam
• niscode
• postcode
• status
• straatnaam
• huisnummer
• busnummer

U ontvangt 1 of meerdere adressen:

• in volgorde van hun gematchte resultaat, het best resultaat staat bovenaan
• met een link naar hun gekoppelde objecten (perceel, gebouweenheid)
• met de coördinaten van het adres (Lambert72)
• ook adressen met busnummers

Beschrijving van de API(opent in nieuw venster)

Zoek een adres of straatnaam via een query (fuzzy) aan de hand van volgende parameters

• query (bijv: q=kerkstraat 1 bus 1)

• gemeentenaam

• niscode

• status

U ontvangt 1 of meerdere adressen:

• met een resultaat string met een objectid en een link naar het detail van het adres
• zonder coördinaten. Door een extra call te doen naar de link van het detail kan u wel de coördinaten bekomen (Lambert72)
• ook adressen met busnummers

Tips bij gebruik:

• Wacht minimaal 300 milliseconden na de laatste toetsaanslag voordat een verzoek naar het endpoint wordt gestuurd. Deze zogeheten debounce-periode sluit aan bij de gemiddelde menselijke reactietijd en wordt algemeen aanbevolen voor zoekinterfaces.

• Pas extra filters toe (zoals gemeentenaam) om de omvang van de zoekopdracht te beperken en de belasting van het systeem te verlagen.

Beschrijving van de API(opent in nieuw venster)

De Geolocation Service converteert adressen naar geografische coördinaten (WGS84, Lambert72 en Lambert2008) die vervolgens kunnen gebruikt worden om een positie aan te duiden op een kaart.

De dienst ontsluit twee resources:

• Suggestion:

  • op basis van een input (string) wordt gezocht naar overeenkomstige adressen in die lijst;

  • de inputstring kan een gemeentenaam, een deelgemeentenaam, een postcode, een straatnaam, een huisnummer en/of delen daarvan bevatten;

  • als antwoord krijg je een deel van de adressenlijst in het formaat ‘Straatnaam huisnummer, Gemeente’.

• Location:

  • als er geen letterlijke overeenkomst wordt gevonden, wordt geprobeerd een gelijkaardig adres te vinden;

  • als antwoord krijg je een lijst van ‘LocationResponse’-entiteiten, die het geformatteerde adres, de omschrijvende rechthoek, de centroïde van de locatie en een indicatie van het soort locatie bevatten.

Meer uitleg staat op de Documentatie van Geolocation.

In deze tabel wordt de aan te raden methode getoond voor verschillende use cases. Soms zijn meerdere methodes mogelijk.

Er wordt geen onderscheid gemaakt tussen de beide methodes uit Geolocation, zie ook hierboven.