GNSS Data Centre

RINEX File Query Web API

You can search either for a single file by its unique file name or for multiple files by a set of search criteria. In both cases, the response returned is a JSON document containing one or more RINEX file download links.

Unauthenticated requests will return open data, while authenticated requests will also return closed data. Data availability (open/closed) for CORS sites is shown in the Site Administration section of the GNSS Site Manager.

The web API is unique in that it offers unauthenticated access to data that has not met GA’s metadata quality assurance criteria. See request parameter metadataStatus.

Find RINEX file by unique file name

GET /api/rinexFiles/{rinexFileName}

Request Header Description Example Values Required Default

Authorization

JWT id token

'Bearer eyJhbGciOiJIU…​'

no
Path Parameter Description Example Values Required Default

rinexFileName

Unique RINEX file name, extension is ignored

'str10010.19d.gz'

yes
Query Parameter Description Example Values Required Default

rinexVersion

List of RINEX versions

'2'

no

'2,3,4'

metadataStatus

Metadata validation status

'valid', 'invalid', 'unvalidated', 'all'

no

'valid'

decompress

Decompress RINEX files

'true'

no

'false'

Curl Example

$ curl 'https://data.gnss.ga.gov.au/api/rinexFiles/str10010.19d.gz?rinexVersion=2'
HTTP/1.1 200 OK

[ {
  "siteId" : "str1",
  "fileType" : "obs",
  "filePeriod" : "01D",
  "startDate" : "2019-01-01T00:00:00Z",
  "rinexVersion" : "2",
  "fileLocation" : "https://s3.ap-southeast-2.amazonaws.com/...", (1)
  "metadataStatus" : "unvalidated",
  "createdAt" : "2019-01-02T00:10:00Z",
  "modifiedAt" : "2024-11-20T01:41:07.989Z",
  "fileId" : "4f1c4811-de75-43b4-851f-5000fea56337"
} ]
1 File download link 
$ curl -OJ 'https://s3.ap-southeast-2.amazonaws.com/...'

Find RINEX files matching supplied criteria

GET /api/rinexFiles

Request Header Description Example Values Required Default

Authorization

JWT id token

'Bearer eyJhbGciOiJIU…​'

no

Accept-Encoding

Request compressed response

'gzip'

no
Query Parameter Description Example Values Required Default

stationId

List of site ids

'str1,str3'

yes

startDate

UTC start date

'2018-01-18T14:00:00Z'

yes

endDate

UTC end date

'2018-03-19T14:00:00Z'

yes

filePeriod

List of RINEX file periods

'01D'

no

'01D,01H,15M'

fileType

List of RINEX file types

'obs'

no

'met,nav,obs'

rinexVersion

List of RINEX versions

'2'

no

'2,3,4'

metadataStatus

Metadata validation status

'valid', 'invalid', 'unvalidated', 'all'

no

'valid'

decompress

Decompress RINEX files

'true'

no

'false'

Curl Example

$ curl 'https://data.gnss.ga.gov.au/api/rinexFiles?stationId=str1,str9&startDate=2019-01-01T00:00:00Z&endDate=2019-01-09T00:00:00Z&filePeriod=01D&fileType=obs&rinexVersion=2,3'
HTTP/1.1 200 OK

[ {
  "siteId" : "str1",
  "fileType" : "obs",
  "filePeriod" : "01D",
  "startDate" : "2019-01-01T00:00:00Z",
  "rinexVersion" : "2",
  "fileLocation" : "https://s3.ap-southeast-2.amazonaws.com/...", (1)
  "metadataStatus" : "unvalidated",
  "createdAt" : "2019-01-02T00:10:00Z",
  "modifiedAt" : "2024-11-20T01:41:07.989Z",
  "fileId" : "4f1c4811-de75-43b4-851f-5000fea56337"
}, {
  "siteId" : "str9",
  "fileType" : "obs",
  "filePeriod" : "01D",
  "startDate" : "2019-01-09T00:00:00Z",
  "rinexVersion" : "3",
  "fileLocation" : "https://s3.ap-southeast-2.amazonaws.com/...", (1)
  "metadataStatus" : "invalid",
  "metadataErrors" : [ {
    "error" : "Missing field",
    "field" : "IERS DOMES number"
  }, {
    "error" : "Unexpected value",
    "field" : "Antenna marker ARP east ecc",
    "found" : "0.0",
    "expected" : "1.0"
  } ],
  "createdAt" : "2024-11-20T01:41:08.349Z",
  "modifiedAt" : "2024-11-20T01:41:08.349Z",
  "fileId" : "ce727f88-9b62-4e17-95c5-285241ce80e9"
} ]
1 File download links 
$ curl -OJ --compressed 'https://s3.ap-southeast-2.amazonaws.com/...'

Authenticated Access

Refer to Section Authorisation if you require access.

Python Example

The following Python script demonstrates how to authenticate against the API and access closed data:

https://bitbucket.org/geoscienceaustralia/gnss-data/src/master/example-scripts/python/find_rinex_files.py