Glass API for GNSS Queries
" }, "servers": [ { "description": "API Pan European Node", "url": "https://glass.gnss-epos.eu/GlassFramework/webresources" } ], "tags": [ { "name": "Station Metadata (EPOS-GNSS)", "description": "Get station metadata using selection criteria, outputs in EPOS-GNSS formats", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/glass-api-section-stations/" } }, { "name": "Station Metadata (EPOS-ICS)", "description": "Get station metadata using location criteria, outputs in EPOS ICS Geojson format", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/section_metadata_ics/" } }, { "name": "Station Metadata (SONEL)", "description": "Get station metadata in accord with the SONEL API", "externalDocs": { "description": "Find out more", "url": "https://api.sonel.org/v1/doc/index.html#/operations/getObsGnssMeta" } }, { "name": "LogFiles", "description": "Download of Station Metadata in geodesyML or IGS site log format", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/glass-api-section-logfiles/" } }, { "name": "List of search parameters", "description": "List containing existing values for a chosen parameter (station name, antenna type, country name…)", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/glass-api-section-data/" } }, { "name": "RINEX File Metadata and URLs", "description": "Get file metadata including url in EPOS-GNSS formats", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/glass-api-section-t2-rinex-file-metadata/" } }, { "name": "RINEX File Quality Check information", "description": "Get file Quality Check information about RINEX files", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/glass-api-section-rinex-file-quality/" } }, { "name": "High Rate RINEX File Metadata and URLs", "description": "Get RINEX high rate info metadata including url in EPOS-GNSS formats", "externalDocs": { "description": "Find out more", "url": "https://gnss-epos.eu/glass-api/glass-api-section-high-rate-rinex-file/" } }, { "name": "API Info", "description": "Operations about the info of the Current Glass API" } ], "paths": { "/stations/station/{size}/{format}": { "get": { "summary": "Returns all stations in the expected format", "tags": [ "Station Metadata (EPOS-GNSS)" ], "description": "GET STATION V2 - Returns all stations in the expected format.\n\n\nPlease specify the output size as one of the options below:\n
\n\n
\nPlease specify the output format as one of the options below:\n
\nPlease input the size as one of the options below:\n
\n\n
\nPlease input the format as one of the options below:\n
\n Multiple values for marker should be separated by , (COMMA)\n
", "parameters": [ { "name": "format", "in": "path", "description": "output file format", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["json","geojson","csv","xml"] } }, { "name": "station-marker", "in": "path", "description": "Marker of the station(s)", "required": true, "style": "simple", "explode": false, "schema": { "type": "string" } }, { "name": "size", "in": "path", "description": "short or full data (full is slower)", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["short","full"] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } } } } }, "/stations/coordinates/{area}/{size}/{format}": { "get": { "summary": "Get the station(s) that are inside the specified perimeter", "tags": [ "Station Metadata (EPOS-GNSS)" ], "description": "GET STATION BY COORDINATES V2 - Returns the station(s) that are inside the specified perimeter.\n\n\nPlease specify the output output size as one of the options below:\n
\n\n
\nPlease specify the ouput format as one of the options below:\n
\nPlease specify the bounding box type as one of the formats below:\n
\n Circle parameters:\n
\n Polygon parameters:\n
\n Rectangle parameters:\n
The parameters must be separated by &(AMPERSAND)
\n\n Side note: by default, parameters are filled with -999. If this value is changed, is assumed you want to use it;\n
", "parameters": [ { "name": "area", "in": "path", "description": "format of the perimeter, e.g. circle", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["Circle","Polygon","Rectangle"] } }, { "name": "format", "in": "path", "description": "output file format", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["json","geojson","csv","xml"] } }, { "name": "size", "in": "path", "description": "short or full data (full is slower)", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["short","full"] } }, { "name": "centerlat", "in": "query", "description": "- for circle only e.g. 43.034", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "centerlon", "in": "query", "description": "- for circle only e.g. 7.013", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "maxlat", "in": "query", "description": "- for rectangle only e.g. 47.0", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "maxlon", "in": "query", "description": "- for rectangle only e.g. 8.8", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "minlat", "in": "query", "description": "- for rectangle only e.g. 43.0", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "minlon", "in": "query", "description": "- for rectangle only e.g. 6.5", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "polygon", "in": "query", "description": "- for polygon only e.g. 42.0,7.0;32.1,7.4;37,4.6", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "radius", "in": "query", "description": "- for circle only e.g. 50 (km)", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } } } } }, "/stations/location/{type}/{instance}/{size}/{format}": { "get": { "summary": "Get station by Location", "tags": [ "Station Metadata (EPOS-GNSS)" ], "description": "GET STATION BY Location V2 - Returns the station(s) that belong to the specified type.\n Please specify the output type as one of the options below:\n
\nPlease specify the output size as one of the options below:\n
\n\n
\nPlease specify the output format as one of the options below:\n
\nPlease specify the output size as one of the options below:\n
\n\n
\nPlease specify the output format as one of the options below:\n
\n Multiple values for agency should be separated by , (COMMA)\n
", "parameters": [ { "name": "agency", "in": "path", "description": "agency(ies) to which the stations belong e.g. OCA-Geoazur", "required": true, "style": "simple", "explode": false, "schema": { "type": "string" } }, { "name": "format", "in": "path", "description": "output file format", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["json","geojson","csv","xml"] } }, { "name": "size", "in": "path", "description": "short or full data (full is slower)", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["short","full"] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } } } } }, "/stations/network/{network}/{size}/{format}": { "get": { "summary": "Get station by network", "tags": [ "Station Metadata (EPOS-GNSS)" ], "description": "GET STATION BY NETWORK V2 - Returns the station(s) that belong to the specified network(s).\n\n\nPlease specify the output size as one of the options below:\n
\n\n
\nPlease specify the output format as one of the options below:\n
\n Multiple values for network should be separated by , (COMMA)\n
", "parameters": [ { "name": "format", "in": "path", "description": "output file format", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["json","geojson","csv","xml"] } }, { "name": "network", "in": "path", "description": "network(s) to which the stations belong", "required": true, "style": "simple", "explode": false, "schema": { "type": "string" } }, { "name": "size", "in": "path", "description": "short or full data (full is slower)", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["short","full"] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } } } } }, "/stations/combination/{size}/{format}": { "get": { "summary": "Get station by filters", "tags": [ "Station Metadata (EPOS-GNSS)" ], "description": "GET STATION COMBINATION V2 - Returns the station(s) that match the parameters.\n\n\nPlease specify the output size as one of the options below:\n
\n\n
\n Please specify the output format as one of the options below:\n
\n The parameters accepted are:\n
\n The parameters should be separated by & (AMPERSAND)\n
\n\n\n Multiple values for a specified parameter should be separated by , (COMMA)\n
\n\n\n Note: the results are an INTERSECTION of the parameters, but each parameter may contain multiple values.\n
\n\nSo if the value of the country parameter is 'France,Italy' and the coordinate parameter is a rectangle large enough to contain stations from France, Italy and Switzerland, only stations from France and Italy will show up.\n
\n\nAn example of a query could be:
\nhttp://localhost:8080/GlassFramework/webresources/stations/v2/combination/short/csv?country=France,Italy&network=RENAG&coordinates=circle¢erlat=44.2¢erlon=7.1&radius=100
", "parameters": [ { "name": "format", "in": "path", "description": "output file format, e.g. csv", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["json","csv","xml"] } }, { "name": "size", "in": "path", "description": "output size, e.g. short", "required": true, "style": "simple", "explode": false, "schema": { "type": "string", "enum":["short","full"] } }, { "name": "agency", "in": "query", "description": "station's agency e.g. IGN France", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "altitude", "in": "query", "description": "Altitude range e.g. 400,900", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "antenna", "in": "query", "description": "station's antenna e.g. LEIAT302-GP", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "centerLat", "in": "query", "description": "for coord. circle only e.g. 43.2", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "centerLon", "in": "query", "description": "for coord. circle only e.g. 10.0", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "city", "in": "query", "description": "station's city e.g. Cascais", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "constellation", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "coordinates", "in": "query", "description": "format of the perimeter, e.g. circle", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "station's country e.g. Portugal", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "dataAvailability", "in": "query", "description": "T2 minimum percentage of data available (e.g. 75) between the number of days the station was installed and the days that have files", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "dateRange", "in": "query", "description": "T2 date range to use relatively to files e.g. 20150115,2017-10-24", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "date_from", "in": "query", "description": "starting date, stations that were active after this date, e.g. 19990125", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "date_to", "in": "query", "description": "ending date, station was active previously to this date, e.g. 20171027", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "elevangle", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "fileType", "in": "query", "description": "T2 type of the files e.g. RINEX2", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "frequency", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "geojson", "in": "query", "description": "a GeoJSON as bounding box (e.g. http://geojson.io)", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "installedDateMax", "in": "query", "description": "maximum date for the installation of a station e.g. 2007-06-24", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "installedDateMin", "in": "query", "description": "minimum date for the installation of a station e.g. 20070113", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "invertedNetworks", "in": "query", "description": "networks to which the station doesn't belong e.g. RENAG,EUREF", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "latitude", "in": "query", "description": "Latitude range e.g. 30,40", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "lifetime", "in": "query", "description": "Minimum amount of days a station was installed e.g. 650", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" } }, { "name": "longitude", "in": "query", "description": "Longitude range e.g. -15,20", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "marker", "in": "query", "description": "station's marker, e.g. LAGO", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "maxAlt", "in": "query", "description": "station's maximum altitude e.g. 580", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "maxLat", "in": "query", "description": "for coord. rectangle only e.g. 46.2", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "maxLon", "in": "query", "description": "for coord. rectangle only e.g. 15.5", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "minAlt", "in": "query", "description": "station's minimum altitude e.g. 80.5", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "minLat", "in": "query", "description": "for coord. rectangle only e.g. 5", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "minLon", "in": "query", "description": "for coord. rectangle only e.g. 41", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "minimumObservationDays", "in": "query", "description": "Minimum amount of days with files e.g. 400", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" } }, { "name": "minimumObservationYears", "in": "query", "description": "Minimum amount of years with files e.g. 5", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "multipathvalue", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "nbclockjumps", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" } }, { "name": "nbcycleslips", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" } }, { "name": "network", "in": "query", "description": "station's network e.g. EUREF", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "observationtype", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "polygon", "in": "query", "description": "for polygon only e.g. 42.0,7.0;32.1,7.4;37,4.6", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "radius", "in": "query", "description": "for coord. circle only e.g. 50", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "radome", "in": "query", "description": "station's radome e.g. OLGA", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "ratioepoch", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "receiver", "in": "query", "description": "station's receiver e.g. ASHTECH GG24C", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "removedDateMax", "in": "query", "description": "maximum date for the removal of a station e.g. 20170214", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "removedDateMin", "in": "query", "description": "minimum date for the removal of a station e.g. 2017-01-17", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "samplingFrequency", "in": "query", "description": "T2 sampling frequency e.g. 30s or 1s", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "samplingWindow", "in": "query", "description": "T2 sampling window e.g. 24h or 1h", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "satelliteSystem", "in": "query", "description": "satellites supported by the station e.g. GPS,GLO", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "site", "in": "query", "description": "station's site name, e.g. Lagos", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "spprms", "in": "query", "required": false, "style": "form", "explode": true, "schema": { "type": "number" } }, { "name": "state", "in": "query", "description": "station's state e.g. Lisbon", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "statusfile", "in": "query", "description": "T2 status file e.g. -3 or 2 or 1 or 0 or 1 or 2 or 3", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "description": "page number using 1-based indexing (empty or zero means all records)", "required": false, "style": "form", "explode": true, "schema": { "type": "integer", "default": 1 } }, { "name": "perpage", "in": "query", "description": "number of files per page. The default is 50", "required": false, "style": "form", "explode": true, "schema": { "type": "integer", "default": 50 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "string" } }, "application/octet-stream;charset=utf-8": { "schema": { "type": "string" } }, "application/xml": { "schema": { "type": "string" } } } } } } }, "/stations/observations/gnss/meta": { "get": { "summary": "Returns a json array containing mete data on the stations", "tags": [ "Station Metadata (SONEL)" ], "description": "GET a STATION array LIST - Returns a list with the name, marker and other attributes as per the SONEL API ", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Station" } } } } } } } }, "/stations/list/station": { "get": { "summary": "Returns a quick and short list containing all station markers", "tags": [ "List of search parameters" ], "description": "GET STATION LIST - Returns a list with the name and marker of all the stations or the ones that match the given parameters.\n\nOptional parameters are:\n
\nThis can be passed as:\nname=Blieux or marker=BLIX,CASC or epos=non-epos\n
\n\nDifferent parameters should be separated by & (AMPERSAND)\n
\n\n Multiple values for a parameter should be separated by , (COMMA)\n
", "parameters": [ { "name": "marker", "in": "query", "description": "4 Char Marker of the station(s)", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "markerlongname", "in": "query", "description": "9 Char Marker of the station(s)", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "description": "Name of the station(s)", "required": false, "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Station" } } } } } } } }, "/stations/station/bbox/{minLon}/{minLat}/{maxLon}/{maxLat}": { "get": { "summary": "Get station by bounding box", "tags": [ "Station Metadata (EPOS-ICS)" ], "description": "GET STATION BOUNDING BOX - Returns all the stations that are inside the bounding box in multiple outputs\n\n\nPlease specify the output format as one of the options below in headers:\n
\n Input can be created using http://geojson.io\n
\n\n\nPlease specify the output format as one of the options below:\n
\nChoose the type of data you want to obtain from the list below:\n
\n\ntype - the type of the criteria\n
\ninstance - the value of the criteria (e.g. for country criteria may be France)\n
\n\n\n\nformat - the format of the output\n
\n\n
\ninstance - the value of the marker\n
\n\n\n\nformat - the format of the output\n
\ninstance - Combine one or more of the next criteria\n
\nformat - the format of the output\n
\ninstance - Combine one or more of the next criteria\n
To get all Data Center Acronym: https://gnssdata-epos.oca.eu/GlassFramework/webresources/t0-manager/getDataCenter
\n\n\n\nformat - the format of the output\n
\n\n
\ninstance - the value of the marker\n
\n\n\n\nformat - the format of the output\n
\n\n
\ninstance - the value of the marker\n
\n\n\n\nformat - the format of the output\n
\nPlease specify the output format as one of the options below in headers:\n