GET v3/Location?q={q}&latlon={latlon}&xy={xy}&poi={poi}&c={c}

Geocoding provides the location of an address. Reverse geocoding provides the closest address based on a given location.

Request Information

Parameters

NameDescriptionAdditional information
q
[Optional] A free form search string. May contain community names, sub-community area names, zip codes, street names, house numbers or parts thereof. A minimum of two characters is required.

Define this parameter in the request URI.

latlon
[Optional] A coordinate in WGS84 projection. Input takes the form [lat,lon] where lat and lon are provided in decimal degrees.

Define this parameter in the request URI.

xy
[Optional] A coordinate in Lambert-72 projection. Input takes the form [x,y] where x and y are provided in meters.

Define this parameter in the request URI.

poi
Obsolete [Optional] The name of a Point of Interest, or a part thereof.

Define this parameter in the request URI.

c
[Optional] The maximum number of items you want to retrieve in the result. You may not ask more than 5 items. If omitted defaults to 1.

Define this parameter in the request URI.

Response Information

Response body formats

application/json, text/json

Sample:
{
  "LocationResult": [
    {
      "ID": 1234,
      "FormattedAddress": "Trambergstraat 1, 3520 Zonhoven",
      "Location": {
        "Lat_WGS84": 50.991974017459327,
        "Lon_WGS84": 5.3517046535166282,
        "X_Lambert72": 219009.14,
        "Y_Lambert72": 187317.72
      },
      "LocationType": "basisregisters_huisnummer_afgeleidVanObject",
      "BoundingBox": {
        "LowerLeft": {
          "Lat_WGS84": 50.991974017459327,
          "Lon_WGS84": 5.3517046535166282,
          "X_Lambert72": 219009.14,
          "Y_Lambert72": 187317.72
        },
        "UpperRight": {
          "Lat_WGS84": 50.991974017459327,
          "Lon_WGS84": 5.3517046535166282,
          "X_Lambert72": 219009.14,
          "Y_Lambert72": 187317.72
        }
      }
    }
  ]
}

text/javascript, application/javascript, application/json-p

Sample:
({"LocationResult":[{"ID":1234,"FormattedAddress":"Trambergstraat 1, 3520 Zonhoven","Location":{"Lat_WGS84":50.991974017459327,"Lon_WGS84":5.3517046535166282,"X_Lambert72":219009.14,"Y_Lambert72":187317.72},"LocationType":"basisregisters_huisnummer_afgeleidVanObject","BoundingBox":{"LowerLeft":{"Lat_WGS84":50.991974017459327,"Lon_WGS84":5.3517046535166282,"X_Lambert72":219009.14,"Y_Lambert72":187317.72},"UpperRight":{"Lat_WGS84":50.991974017459327,"Lon_WGS84":5.3517046535166282,"X_Lambert72":219009.14,"Y_Lambert72":187317.72}}}]});