Find the nearest Belgian address to a GPS point

Send a latitude and a longitude and get the closest official addresses back, each with its distance in metres.

Endpoint
GET https://addrly.be/api/v1/geocode/reverse

Get a free API key Full reference and response fields

When to use it

Turning the position of a phone or a vehicle into a street address.
Naming the place where a photo, an inspection or an incident was recorded.
Checking that a point on a map falls on a real address.

Cost: 1 request per call
Authentication: X-API-Key header
Coverage: Every official address in Belgium

Query parameters

Parameter	Type	Description
`lat` required	`number`	Latitude, in decimal degrees (WGS84). From -90 to 90
`lon` required	`number`	Longitude, in decimal degrees (WGS84). From -180 to 180
`limit` optional	`integer`	How many addresses to return, nearest first. From 1 to 5 Default: 1

Request

curl "https://addrly.be/api/v1/geocode/reverse?lat=50.8467&lon=4.3499&limit=1" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "count": 1,
  "results": [
    {
      "distance_m":      12.4,
      "street_fr":       "Rue de la Loi",
      "street_nl":       "Wetstraat",
      "house_number":    "16",
      "postcode":        "1000",
      "municipality_fr": "Bruxelles",
      "municipality_nl": "Brussel",
      "lat":             50.8467,
      "lon":             4.3499
    }
  ]
}