Welcome to the AGIV Geolocation API!

The Geolocation API provides resources for auto-completion, geocoding and reverse geocoding within the regions of Flanders and Brussels.

Data

The data underlying this service is extracted from CRAB, UrbIS-Adm and POI. It is updated once a day.

The data for the region of Brussels contains both the Dutch and French notation of addresses.

High-level use cases

Suggestion

Suggestion allows client applications to provide auto-completion functionality for a free form single search line. Input can be either partial address information or partial poi name.

SuggestionResult

Contains a list of items resembling the input string. The list may contain between zero and n items, where n is the maximum number of items indicated in your request or otherwise the default of 5.

Example


Location

Geocoding is the process of matching an address to its correct location on a map. Client applications can pass free form single search line with partial address information or one of the results of the suggestion resource. Result is either a single record exactly matching the input or a set of records ranked by relevance when the input is ambiguous.

The reverse geocoding interface allows client applications to retrieve the closest address based on a given coordinate. If no address is found within 1.000 m of the provided coordinate, nothing is returned.

LocationResult

Contains a list of geo-locations. The list may contain between zero and n items, where n is the maximum number of items indicated in your request or otherwise the default of 1.

example


Versions

If no specific version is indicated then the latest version is the default.

V1

Version 1 provides a Suggestion and a Location resource as described above.

V2

Version 2 has the exact same interface as version 1, but adds the zip code to the SuggestionResult and to the FormattedAddress within the LocationResult for location types 'crab_huisnummer' and 'urbis_huisnummer'. Keep in mind that no zip code is added for location types 'crab_straat', 'urbis_straat', 'crab_gemeente' or 'urbis_gemeente'.

V3

Version 3 returns within the LocationResult not only a FormattedAddress but also an ID that can be used for further lookups. Where the ID points to depends on the LocationType.
Mind you that this version no longer supports parcel search. Please refer to perc.geopunt.be for parcel search.

V4

Version 4 adds more information to the location responses, i.e. an explicit listing of the individual address components municipality, zipcode, thoroughfarename and housenumber. Furthermore the resultset can now be filtered to include only municipalities, thoroughfarenames or full addresses.
Mind you that this version no longer supports poi search. Please refer to poi.geopunt.be for poi search.

Cross-domain requests

The service supports JSON-P. Add the query parameter 'callback' to the url and set the Accept header to 'application/javascript'.

CORS is not supported.