geowiki

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

Geocoding can be done using the following URL:

 //apiv3.geoportail.lu/geocode/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
• returnParcelInfo sends back the parcel number if set to true

Full example:

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

Alternative:

• queryString: formatted address in one string
• dc random number
• cb: callback function name

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

Return parameters

• success: success true/false
• count: Number of results found
• results: List order by descending accuracy and ratio
  • parcel optional, according to request parameter returnParcelInfo true/false
    • key parcel id
    • label parcel label
  • ratio: ratio from 0-1. Expresses the certainty of the result, 1 being the maximum
  • name: Formatted string representing the addresse
  • easting: East Coordinate in LUREF Coords
  • northing: North Coordinate in LUREF Coords
  • address: Address String
  • geom : geojson Geometry Object with coordinates in LUREF X,Y
  • geomlonlat: geojson Geometry Object with coordinates in WGS84 Lat/Lon
  • matching street: Name of the street
  • accuracy: Codes from 0 - 8 expressing the level of geocoding(
    • 8. at house number level
    • 7. at point of interest level
    • 6. at street level
    • 5. at locality level
    • 1. at national level (Luxembourg)
  • AddressDetails: Address Details
    • zip: Postcode
    • Locality: locality
    • id_caclr_street: Street ID in national Address DB
    • street: street name
    • postnumber: hosuenumber
    • id_caclr_building: Building ID in national Address DB

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}

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:

• lat: latitude in WGS84 Coordinates
• lon: longitude in WGS84 Coordinates
• cb: callback function name

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

Return parameters

• count: Number of results found
• results: List order by ascending distance
  • distance: distance in m to the address
  • geom: geojson object with the coordinates of the point in LUREF coordinates
  • geomlonlat: geojson Geometry Object with coordinates in WGS84 Lat/Lon
  • name: formatted address string
  • easting: East Coordinate in LUREF coordinates
  • northing: North Coordinates in LUREF coordinates
  • address: formatted address string
  • zip: Postcode
  • Locality: locality
  • id_caclr_street: Street ID in national Address DB
  • street: street name
  • postnumber: hosuenumber
  • id_caclr_building: Building ID in national Address DB

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]}}]}