Table of Contents

Documentation about some of the rest interfaces used in the geoadmin api

Some of the functions of the geoAPI use rest services. They can also be used in an independant way, give a valider refering URL.

Some of those REST services are described here

geocode

Geocoding can be done using the following URL:

api.geoportail.lu/geocoder/search Parameters: * num: House number * street: Street name * locality: Locality * zip: Postcode * dc: random number (optional) to prevent caching * cb: callback function name. If specified return JSONP rahter than JSON Full example: api.geoportail.lu/geocoder/search?num=54&street=Avenue%20Gaston%20Diderich&zip=&locality=Luxembourg&_dc=1386599465147&cb=stcCallback1001

Alternative:

Example: 
//api.geoportail.lu/geocoder/search?queryString=54,%20avenue%20Gaston%20Diderich,1420%20%20Luxembourg

Return parameters

Result:

{"count": 2, "results": [{"ratio": 1.0, "name": "54,Avenue Gaston Diderich 1420 Luxembourg", "easting": 75983.84375, "address": "54 Avenue Gaston Diderich,1420 Luxembourg", "geomlonlat": {"type": "Point", "coordinates": [6.11255434207935, 49.6106117587006]}, "geom": {"type": "Point", "coordinates": [75983.84375, 75110.6796875]}, "northing": 75110.6796875, "AddressDetails": {"zip": "1420", "locality": "Luxembourg", "id_caclr_street": "19", "street": "Avenue Gaston Diderich", "postnumber": "54", "id_caclr_building": "1088"}, "matching street": "Avenue Gaston Diderich", "accuracy": 8}, {"ratio": 1.0, "name": ",Avenue Gaston Diderich 1420 Luxembourg", "easting": 75643.185748922406, "address": " Avenue Gaston Diderich,1420 Luxembourg", "geomlonlat": {"type": "Point", "coordinates": [6.1078415667193298, 49.6100594816659]}, "geom": {"type": "Point", "coordinates": [75643.185748922406, 75049.512442753199]}, "northing": 75049.512442753199, "AddressDetails": {"zip": "1420", "locality": "Luxembourg", "id_caclr_street": "19", "street": "Avenue Gaston Diderich", "postnumber": "None", "id_caclr_building": ""}, "matching street": "Avenue Gaston Diderich", "accuracy": 6}], "success": true}

reverse geocode

Geocoding can be done using the following URL:

api.geoportail.lu/geocoder/reverseGeocode Parameters: * easting: East Coordinate in LUREF Coordinates * northing: North Coordinate in LUREF Coodinates * dc: random number (optional) to prevent caching * cb: callback function name. If specified return JSONP rahter than JSON Full example: api.geoportail.lu/geocoder/reverseGeocode?easting=80000&northing=80000

Alternative:

Example: 
//api.geoportail.lu/geocoder/reverseGeocode?lon=6.11249&lat=49.61055

Return parameters

Result:

{"count": 1, "results": [{"distance": 8.2954085109112103, "geom": {"type": "Point", "coordinates": [75983.84375, 75110.6796875]}, "name": "23,Avenue des Archiducs 1135 Luxembourg", "easting": 75983.84375, "address": "23 Avenue des Archiducs,1135 Luxembourg", "geomlonlat": {"type": "Point", "coordinates": [6.11255434207935, 49.6106117587006]}, "AddressDetails": {"zip": "1135", "locality": "Luxembourg", "id_caclr_street": "15", "street": "Avenue des Archiducs", "postnumber": "23", "id_caclr_building": "571"}, "matching street": "Avenue des Archiducs", "northing": 75110.6796875}], "success": true}