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:

 //apiv3.geoportail.lu/geocode/search

Parameters:

Full example:

 //apiv3.geoportail.lu/geocode/search?num=54&street=Avenue%20Gaston%20Diderich&zip=&locality=Luxembourg&_dc=1386599465147&cb=stcCallback1001

Alternative:

Example: 
//apiv3.geoportail.lu/geocode/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:

apiv3.geoportail.lu/geocode/reverse 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: apiv3.geoportail.lu/geocode/reverse?easting=80000&northing=80000

Alternative:

Example: 
//apiv3.geoportail.lu/geocode/reverse?lon=6.11249&lat=49.61055

Return parameters

Result: {“count”: 1, “results”: [{“id_caclr_street”: “19”, “id_caclr_bat”: “1088”, “street”: “Avenue Gaston Diderich”, “number”: “54”, “locality”: “Luxembourg”, “postal_code”: “1420”, “country”: “Luxembourg”, “country_code”: “lu”, “distance”: 10.4646819204298, “contributor”: “ACT”, “geom”: {“type”: “Point”, “coordinates”: [75982.8968, 75113.6107995489]}, “geomlonlat”: {“type”: “Point”, “coordinates”: [6.11254086249795, 49.6106380870988]}}]}