Overview
The GNSS Stations API is a service dedicated to EPOS. It provides access to M3G’s metadata catalogue of GNSS stations sharing data through EPOS. The service has been built to allow the visualisation and the exploration of GNSS current station information within EPOS Data Portal. In addition to the visualization, it also allows to download standardized GNSS station metadata, including IGS-style site logs, and linked GNSS networks, as well as information on the station’s datasets such Digital Object Identifiers (DOIs) and data licenses.
Available Views on ICS Data Portal
- Map View — Explore GNSS stations interactively on a map and show GNSS site pictures when available.
- Table View — View GNSS station information on a table view.
- Download View — Download GNSS station metadata files related to each station, such as standardized IGS site logs, standardized GeodesyML files, station hardware changes, GNSS site pictures, and station metadata in JSON format.
Downloadable Files
The API gives access link to the station-related resources:
- GNSS Site Pictures — Download links to site pictures (e.g. GNSS equipment, site environment).
- GeodesyML Files — Download link to the standardized GeodesyML.
- IGS Site Logs — Download link to the standardized IGS site logs.
- Equipment and environment Change Records — API link to the historical equipment and environmental changes of GNSS stations in JSON format.
- GNSS Station Information — API link to the station metadata in JSON format.
Supported Filters (Query Parameters)
Geospatial Filters
minlat,maxlat,minlon,maxlon— Bounding box for spatial queries.
Temporal Filters
minDate,maxDate— Define the start and end dates (format: "YYYY-MM-DD hh:mm") to retrieve GNSS stations that were active during the specified time period.
Network and Node Filters
network— Filter by GNSS network. (A. Marussi, AGN, AGRS.BES, AGRS.NL, ARAGEA, ASGEUPOS, BAN, BFA, BME, C4G, CNMSU, COP2020, CYCLOPS, CZEPOS, CatNet, DEEP-trigger, DJ, EPN, EPOS, ERGAND, ERGNSS, ERVA, ESTPOS, EUSKADIGNSS, FLEPOS, FReDNet, GEONAS, GFA, GFZ, GL, GNSSCAR, GeoPontica, GeoTerrace, IGRS.NL, IGS, ITACYL, KNMI, LatPos, LitPOS, MAO_GNSS, MQ, NETPOS, NIEP_GNSS, NMA-CORS, NOANET, OMIV, OS Net, Orpheon, PE, PF, PPGNET, QM, RAP, REDGNSSCANT, REGAM, RENAG, REP, REPCAN, REPGRAM, REPRAA, RGAN, RGAPA, RGM, RGP, RING, ROB_GNSS, ROMPOS, ROSAME, ReNEP, SKPOS, SPIN3, SPSLUX, STPOS, SWEPOS, System.NET, TERIA, TGRef, UPAT-DGnet, UPN_GNSS, VESOG, WALCORS, WEBGEODYN, WI, XGAIB, ZAKPOS)virtual— Filter by virtual network flag. (NFO_MARMARA, NFO_NITRO, NFO_TABOO, NFO_VRANCEA, VOLC)node— EPOS data node identifier. (Belgian-node, C4G, CEGNxEPOS, French-node, IGE, IPGP-GNSS, IRN, NOA, Pan-European, ROB-EUREF, SONEL)
Additional Filters
country— ISO country code. (ALB,AND,ARM,ATA,ATF,AUT,BEL,BES,BGR,BIH,BLM,BLR,CHE,CHL,CYP,CZE,DEU,DJI,DMA,DNK,ESP,EST,FIN,FRA,FRO,GBR,GLP,GRC,GRL,GUF,HRV,HUN,IRL,ISL,ISR,ITA,JOR,LTU,LUX,LVA,MAF,MAR,MDA,MKD,MLT,MNE,MTQ,MYT,NCL,NLD,NOR,PER,POL,PRT,PYF,REU,ROU,RUS,SMR,SPM,SRB,SVK,SVN,SWE,TUR,UKR,WLF)owner— Data provider or organization. (e.g. Royal Observatory of Belgium)format— Downloadable format (metadata-sitelog,metadata-geodesyml,metadata-json,pictures,equipment-changes-json).filter— Advanced JSON-based queries for customized results. (e.g. {stationId : {in:['BRUX00BEL']}}, Check available station list)
Example Requests
Retrieve stations within Italy (GeoJSON)
GET https://gnss-metadata.eu/v1/sitelog/gnss-metadata?minlat=36&maxlat=47&minlon=6&maxlon=19&country=ITA
Retrieve IGS Site Log list for the VOLC Virtual network (GeoJSON)
GET https://gnss-metadata.eu/v1/sitelog/gnss-metadata?virtual=VOLC&format=metadata-sitelog
Retrieve BRUX00BEL station (GeoJSON)
GET https://gnss-metadata.eu/v1/sitelog/gnss-metadata?filter[id][in][0]=BRUX00BEL&format=metadata-sitelog