Endpoint /files/{type}/{instance}/{format}/{page}/{perpage}
This endpoint returns files from stations that meet the criteria entered in the fields.
Using a specific type then the instance must be a direct match to the type.
In addition to these main fields, there is a field to enter the desired output format. Two required fields for pagination, where you can enter the number of elements per page to be displayed and the page you want to be displayed. In addition to a parameter that allows you to exclude files with a status less than zero.
Example of File Search by Agency
-
type
agency
-
instance
Ordnance Survey
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/agency/Royal observatory Belgium/json?filtervalidatedfiles=0&page=1&perpage=50
Example of File Search by Coordinates
Example of File Search by Coordinates Data
Example of File Search by Country
-
type
country
-
instance
Portugal
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/country/Portugal/json?filtervalidatedfiles=0&page=1&perpage=50
Example of File Search by Date Range
Example of File Search by Network
-
type
network
-
instance
C4G
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/network/C4G/json?filtervalidatedfiles=0&page=1&perpage=50
Example of File Search by Published Date of File
Example of File Search by Type of Data Center Acronym
-
type
data_center_acronym
-
instance
EPOSGNSS
format
The format of the output
filtervalidatedfiles
Whether to exclude files with status less than zero. Value 1 to exclude files, or 0 to view all files regardless of status.
page
Number of the page you want to view depends on the number of elements per page chosen.
- 1,2,3,4,5…etc
- 0 to view all records
perpage
Number of elements per page.
Example Links
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/agency/Ordnance%20Survey/json/1/50
- http://localhost:8080/GlassFramework/webresources/files/country/Italy/json/1/50
Endpoint /files/station-marker/{instance}/{format}
This endpoint returns files from stations that meet the station-marker inserted.
To use this endpoint it is only necessary to insert a station marker in the station-marker field, it can be a four-character marker or a nine-character marker.
In addition to these main fields, there is a field to enter the desired output format. Two optional fields for pagination, where you can enter the number of elements per page to be displayed and the page you want to be displayed. In addition to a parameter that allows you to exclude files with a status less than zero.
station-marker
The station-marker of the station. Can be four marker or nine marker. One or more markers can be combined as long as they are separated by a comma.
- AJAC00FRA
- CASC00PRT
- AJAC00FRA,CASC00PRT,ABBS00GBR
- ABBS00GBR,AJAC00FRA
format
The format of the output
filtervalidatedfiles
Whether to exclude files with status less than zero. Value 1 to exclude files, or 0 to view all files regardless of status.
page
Number of the page you want to view depends on the number of elements per page chosen.
- 1,2,3,4,5…etc
- 0 to view all records
perpage
Number of elements per page.
Example Links
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/marker/CASC00PRT/xml?filtervalidatedfiles=0&page=1&perpage=50
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/station-marker/CASC00PRT,ABBS00GBR/json?filtervalidatedfiles=0&page=1&perpage=50
Endpoint /files/combination/{instance}/{format}/{page}/{perpage}
This endpoint returns files from files that meet the criteria entered in the fields.
This endpoint is used to search files using a combination of several different criteria, allowing you to reach impossible combinations or some very specific ones.
In addition to these main fields, there is a field to enter the desired output format. Two required fields for pagination, where you can enter the number of elements per page to be displayed and the page you want to be displayed. In addition to a parameter that allows you to exclude files with a status less than zero.
All possible parameters to combine
- agency
- antenna
- coordinatesº
- coordinates_data
- coordinates_data_list
- country
- date_rangeººº
- file_name
- format
- marker or station-marker
- md5
- network
- published_dateººº
- radome
- receiver
- sampling_frequency
- station_datesºº
- data_center_acronymººº
- º – this object uses “minLat=X&maxLat=X&minLon=X&maxLon=X” as it’s object instance.
- ºº – this objects use “date_from=X&date_to=X” as it’s object instance.
- ººº – this objects use “date_range=2020-01-01,2022-01-01 or published_date=2020-01-01,2022-01-01” as it’s object instance.
- To get all Data Center Acronym: https://gnssdata-epos.oca.eu/GlassFramework/webresources/t0-manager/getDataCenter
instance
The combination of parameters. Combinations can be made with all the parameters presented as long as they are separated by &..
- marker=CASC00PRT&dateRange=2023-01-01,2023-01-20
- agency=Ordnance Survey&city=Aberporth
- published_date=2020-01-01,2022-01-01
format
The format of the output
filtervalidatedfiles
Whether to exclude files with status less than zero. Value 1 to exclude files, or 0 to view all files regardless of status.
page
Number of the page you want to view depends on the number of elements per page chosen.
- 1,2,3,4,5…etc
- 0 to view all records
perpage
Number of elements per page.
Example Links
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/combination/agency=Ordnance Survey&city=Aberporth/xml?filtervalidatedfiles=0&page=1&perpage=50
- https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/combination/marker=CASC&dateRange=2023-01-01,2023-01-20/json?filtervalidatedfiles=0&page=1&perpage=50
Type of Errors Explanation
Code 200
- Ok -> Everything went well and results returned
- Ok but no result -> Nothing was found in the database that matches the request made
- SocketException -> The connection was closed without the results being returned, something may be wrong in the connection with the database.
- SQLException -> An error in the SQL queries, probably some information that you wanted to retrieve has an error or there is no connection in a table.
- ClassNotFoundException -> The Java class could not be found, this implies a serious error in the API, probably a compilation/installation error.
- Error: “format” Format Unknown -> The response format entered in the parameters is invalid, you must only use json, xml, csv or script.
Code 400
- Bad Request -> Check the entered parameters;Verifies that the API server link is correct; Checks the entered parameters.; If everything above is fine, then the API may not be working.
- Invalid object type ->The parameter entered in type is not valid, please confirm that it is correct.
- Invalid parameters[1] ->The number of parameters entered is incorrect.
- Invalid parameters[2] -> Parameter names are incorrect or not entered correctly
