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

Geocoding provides the location of an address or a poi. 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, poi names, coordinates 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
[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, 3120 Zonhoven",
      "Location": {
        "Lat_WGS84": 50.991974017459327,
        "Lon_WGS84": 5.3517046535166282,
        "X_Lambert72": 219009.14,
        "Y_Lambert72": 187317.72
      },
      "LocationType": "crab_huisnummer_afgeleidVanGebouw",
      "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, 3120 Zonhoven","Location":{"Lat_WGS84":50.991974017459327,"Lon_WGS84":5.3517046535166282,"X_Lambert72":219009.14,"Y_Lambert72":187317.72},"LocationType":"crab_huisnummer_afgeleidVanGebouw","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}}}]});