GET v4/Location?q={q}&latlon={latlon}&xy={xy}&type={type}&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.

type
[Optional] The location types you want to restrict the result to. Valid types are 'Municipality', 'Thoroughfarename', 'Housenumber'. The filter has no effect on reverse geocoding requests.

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": [
    {
      "Municipality": "Zonhoven",
      "Zipcode": "3120",
      "Thoroughfarename": "Trambergstraat",
      "Housenumber": "1",
      "ID": 1234,
      "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":[{"Municipality":"Zonhoven","Zipcode":"3120","Thoroughfarename":"Trambergstraat","Housenumber":"1","ID":1234,"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}}}]});