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
Parameter Description

rinexVersion

List of RINEX versions

metadataStatus

Metadata validation status

decompress

Decompress RINEX files

Curl Example

$ curl 'https://data.gnss.ga.gov.au/api/rinexFiles/str10010.19d.gz?rinexVersion=2'  \
    -H 'accept-encoding: gzip'
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-05-09T04:32:47.353Z",
  "fileId" : "0248421b-c30f-4e9d-aa8e-17e71a640e30"
} ]
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
Parameter Description

stationId

List of site ids

startDate

UTC start date

endDate

UTC end date

filePeriod

List of RINEX file periods

fileType

List of RINEX file types

rinexVersion

List of RINEX versions

metadataStatus

Metadata validation status

decompress

Decompress RINEX files

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-05-09T04:32:47.353Z",
  "fileId" : "0248421b-c30f-4e9d-aa8e-17e71a640e30"
}, {
  "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-05-09T04:32:47.759Z",
  "modifiedAt" : "2024-05-09T04:32:47.759Z",
  "fileId" : "fdcddbdf-fdd8-4e3a-9e8e-b284c576b48d"
} ]
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