This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | Previous revision | ||
en:api:rest [2018/04/23 14:12] |
en:api:rest [2020/02/18 14:39] (current) mire |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ==== 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: | ||
+ | |||
+ | // | ||
+ | |||
+ | |||
+ | |||
+ | **Parameters: | ||
+ | *num: //House number// | ||
+ | *street: //Street name// | ||
+ | *locality: // | ||
+ | *zip: // | ||
+ | *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: ** | ||
+ | // | ||
+ | |||
+ | **Alternative: | ||
+ | *queryString: | ||
+ | *dc //random number// | ||
+ | *cb: //callback function name// | ||
+ | |||
+ | Example: | ||
+ | // | ||
+ | |||
+ | **Return parameters** | ||
+ | * success: //success true/ | ||
+ | * 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: | ||
+ | * zip: // | ||
+ | * Locality: // | ||
+ | * id_caclr_street: | ||
+ | * street: //street name// | ||
+ | * postnumber: // | ||
+ | * id_caclr_building: | ||
+ | |||
+ | |||
+ | Result: | ||
+ | {" | ||
+ | |||
+ | === reverse geocode === | ||
+ | |||
+ | Geocoding can be done using the following URL: | ||
+ | |||
+ | |||
+ | // | ||
+ | |||
+ | **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: | ||
+ | // | ||
+ | | ||
+ | **Alternative: | ||
+ | * lat: //latitude in WGS84 Coordinates // | ||
+ | * lon: //longitude in WGS84 Coordinates // | ||
+ | * cb: //callback function name// | ||
+ | |||
+ | Example: | ||
+ | // | ||
+ | |||
+ | **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: // | ||
+ | * Locality: // | ||
+ | * id_caclr_street: | ||
+ | * street: //street name// | ||
+ | * postnumber: // | ||
+ | * id_caclr_building: | ||
+ | |||
+ | **Result**: | ||
+ | | ||
+ | | ||