Begrippenlijst

Geocoding

Adres naar coördinaat

Het omzetten van een adres of plaatsnaam naar geografische coördinaten. Reverse geocoding doet het omgekeerde.

Van zoektekst naar een controleerbare kaartlocatie

Geocoding zoekt de waarschijnlijkste geografische locatie bij een adres, perceel of plaatsnaam. De Geolocation Service van Digitaal Vlaanderen gebruikt geldige adressen uit het Gebouwen- en Adressenregister en geeft een gestandaardiseerd adres, positie en aanvullende locatie-informatie terug.

Rechtstreeks adres opvragen

De Location-resource kan rechtstreeks worden bevraagd met een URL-gecodeerde zoektekst. Voor Nieuwstraat 20 in 1000 Brussel geeft de voorbeeldrequest hieronder één locatie-resultaat terug.

HTTP GET — Geolocation API Vlaanderen
                      GET https://geo.api.vlaanderen.be/geolocation/v4/Location?q=Nieuwstraat%2020%201000%20brussel
                    

JSON-antwoord van de dienst

Het antwoord bevat het gestandaardiseerde adres, een identificator, het locatietype en coördinaten in WGS84, Lambert 72 en Lambert 2008. Daardoor kan dezelfde locatie in een webkaart of Vlaamse GIS-dataset worden gebruikt.

JSON — antwoord voor Nieuwstraat 20, 1000 Brussel
                      {
  "LocationResult": [
    {
      "Municipality": "Brussel",
      "Zipcode": "1000",
      "Thoroughfarename": "Nieuwstraat",
      "Housenumber": "20",
      "ID": 158561,
      "FormattedAddress": "Nieuwstraat 20, 1000 Brussel",
      "Location": {
        "Lat_WGS84": 50.85103991405543,
        "Lon_WGS84": 4.3540218152299435,
        "X_Lambert72": 148962.69,
        "Y_Lambert72": 171182.43,
        "X_Lambert2008": 648962.24,
        "Y_Lambert2008": 671182.71
      },
      "LocationType": "urbis_huisnummer",
      "BoundingBox": {
        "LowerLeft": {
          "Lat_WGS84": 50.85103991405543,
          "Lon_WGS84": 4.3540218152299435,
          "X_Lambert72": 148962.69,
          "Y_Lambert72": 171182.43,
          "X_Lambert2008": 648962.24,
          "Y_Lambert2008": 671182.71
        },
        "UpperRight": {
          "Lat_WGS84": 50.85103991405543,
          "Lon_WGS84": 4.3540218152299435,
          "X_Lambert72": 148962.69,
          "Y_Lambert72": 171182.43,
          "X_Lambert2008": 648962.24,
          "Y_Lambert2008": 671182.71
        }
      }
    }
  ]
}
                    

Controle blijft nodig

Een zoekresultaat is niet automatisch juist. Toon meerdere kandidaten bij dubbelzinnige invoer en laat belangrijke matches visueel controleren voordat ze definitief worden opgeslagen.

Bronnen en verdere documentatie