Geodetic Benchmarks

Resource Information

URL
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks
Response Formats
JSON, XML
Authentication
No
Limited ratio
Yes

API for the geodesic signals in Gipuzkoa. You can use it to consult or obtain geodesic references of the geodesic infrastructure of Gipuzkoa.

Request parameters

Parameter Description Default Required
city Name of the municipality or code of the municipality. - No
q Name of the geodesic signal to search for. If we put the wildcard character asterisk (*) all the names will appear. - No
lang Language. Three are available: eu, es and en. Default, eu. eu No
limit Number of search responses. 1000000 No
type The search will be performed by specifying the object type. There are two types: Geodetic Benchmark and Geodetic Adjustment. Both of them No
viewbox Narrow the search within a geographic window. Parameter format: [minimum_longitude,minimum_latitude,maximum_longitude,maximum_latitude], in the EPSG:4326 coordinate system. The decimal separator must be period. - No
pt If we use the geographical window, we have the possibility to start the search from a central point. In such case, the result will be sorted by distance to the centre. Parameter format: [longitude,latitude], in the EPSG:4326 coordinate system. - No
b5m_id Search using the b5m code. - No
nor Normalized classification of the result, in percentage. Options: [0|1]. 0 No
format Format of the response. It should be: json, xml or php. json No

Examples

1. Search by municipality with code 016
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks?city=016&lang=en
2. Search by the municipality of Eskoriatza
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks?city=eskoriatza&lang=en
3. Search using the geodesic signal called ezko-1
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks?q=ezko-1&lang=en
4. Eskoriatza geodetic adjustment documents
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks?city=016&type=geodetic+adjustment&lang=en
5. Search using a geographic window
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks?q=*&viewbox=-1.84,43.31,-1.74,43.38&lang=en
6. Search using a geographic window and a point
https://b5m.gipuzkoa.eus/api/2.0/geodeticbenchmarks?q=*&viewbox=-1.84,43.31,-1.74,43.38&pt=-1.7599,43.3426&lang=en

Response

Field Description
boundingbox Location of the geographical set of the geodesic signal (minimum bounding box).
link Link to the geodetic benchmark review document.
size_kb Size of the geodetic benchmark document (Kb).
file_type Document type of the geodetic benchmark.
importance Importance of the item in the search. It is a number; and the larger it is, the more important the item will be.
distance Distance to the geodetic benchmark if the point of origin has been indicated (parameter pt). In kilometres.
b5m_id b5m code of the geodetic benchmark.
city Name of the municipality where the geodetic benchmark is located.
lon Longitude of the location of the geodetic benchmark.
lat Latitude of the location of the geodetic benchmark.
map_link URL to see the geodetic benchmark on the b5m map.