Glass API – Section RINEX File Metadata and URLs

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
  • type

    coordinates

  • instance

    minLat=35&maxLat=40&minLon=0&maxLon=10

  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/coordinates/minLat=35&maxLat=40&minLon=0&maxLon=10/json?filtervalidatedfiles=0&page=1&perpage=50
Example of File Search by Coordinates Data
  • type

    coordinates_data

  • instance

    coordinates=rectangle&maxLat=59.60&minLat=55.42&maxLon=32.43&minLon=21.31

  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/coordinates_data/coordinates=rectangle&maxLat=59.60&minLat=55.42&maxLon=32.43&minLon=21.31/json?filtervalidatedfiles=0&page=1&perpage=50
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
  • type

    date_range

  • instance

    date_from=2023-01-01&date_to=2023-01-10

  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/date_range/date_from=2023-01-01&date_to=2023-01-10/json?filtervalidatedfiles=0&page=1&perpage=50
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
  • type

    published_date

  • instance

    date_from=2023-01-01&date_to=2023-01-02

  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/published_date/date_from=2023-01-01&date_to=2023-01-02/json?filtervalidatedfiles=0&page=1&perpage=50
Example of File Search by Type of Data Center Acronym
  • type

    data_center_acronym

  • instance

    EPOSGNSS

format

The format of the output

  • csv
  • json
  • script
  • xml
filtervalidatedfiles

Whether to exclude files with status less than zero. Value 1 to exclude files, or 0 to view all files regardless of status.

  • 1
  • 0
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.

  • 5,10,20,50,100…etc

Example Links
  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/marker/CASC/xml?filtervalidatedfiles=0&page=1&perpage=50
  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/combination/marker%3DCASC%26dateRange%3D2023-01-01%2C2023-01-10/json?filtervalidatedfiles=0&page=1&perpage=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
  • CASC
  • AJAC00FRA,CASC,ABBS
  • ABBS,AJAC00FRA
format

The format of the output

  • csv
  • json
  • script
  • xml
filtervalidatedfiles

Whether to exclude files with status less than zero. Value 1 to exclude files, or 0 to view all files regardless of status.

  • 1
  • 0
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.

  • 5,10,20,50,100…etc
Example Links
  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/marker/CASC/xml?filtervalidatedfiles=0&page=1&perpage=50
  • https://gnssdata-epos.oca.eu/GlassFramework/webresources/files/station-marker/CASC00PRT,ABBS/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=CASC&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

  • csv
  • json
  • script
  • xml
filtervalidatedfiles

Whether to exclude files with status less than zero. Value 1 to exclude files, or 0 to view all files regardless of status.

  • 1
  • 0
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.

  • 5,10,20,50,100…etc
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