GET v2/Location?q={q}&latlon={latlon}&xy={xy}&capakey={capakey}&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

Name	Description	Additional 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.
capakey	Obsolete [Optional] A parcel identifier in capakey notation. At least the first five characters are required.	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": [
    {
      "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":[{"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}}}]});