De Geolocation Service converteert adressen naar geografische coördinaten die vervolgens kunnen gebruikt worden om een positie aan te duiden op een kaart. De dienst ontsluit twee resources:

• Suggestion:
  • bevat een lijst van geldige adressen van het gebouwen- en adressenregister;
  • 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:
  • bevat een lijst van geldige adressen van het gebouwen- en adressenregister en hun positie op het terrein;
  • op dezelfde manier als bij ‘Suggestion’ wordt op basis van de input de lijst gefilterd;
  • 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.

Op volgende URL’s vindt u technische informatie over de functionaliteiten van de Geolocation Service:

Geolocation API Documentation(opent in nieuw venster)

https://geo.api.vlaanderen.be/geolocation/swagger/ui/index(opent in nieuw venster)

Voor elke dienst in productie biedt Digitaal Vlaanderen ook een bèta-dienst aan. Deze bèta-dienst kan gebruikt worden om implementaties tijdens de ontwikkelingsfase van toepassingen te testen. De betreffende bèta-diensten kunnen aangesproken worden via de productie-URL waarbij ‘vlaanderen’ aangepast wordt naar ‘beta-vlaanderen’.

Voor deze diensten garandeert Digitaal Vlaanderen niet dezelfde beschikbaarheid en performantie als voor de diensten in productie. Voor specifieke testscenario’s, bv. loadtesten, contacteer digitaal.vlaanderen@vlaanderen.be(opent in uw e-mail applicatie).