RINEX data is available for full hours, or it can be requested for a desired duration. A full hour is available roughly 5 minutes after the hour is complete. You can request data for the last 356 days.

When using the swipos-API, the following conventions apply:

Dates, times and durations are expressed in a custom format that is based on ISO 8601.

GPS time is usually given in seconds, and is related to the international atomic time (TAI). This differs from the Universal Time Coordinated (UTC), which is kept synchronized to the earth's rotation by leap seconds. The relation can be expressed as GPSTime = UTC + 18s

To simplify the use of the swipos-API, we kept the formats proposed in ISO 8601, and added G as a timezone indicator instead of the Z used for UTC time. Times that do not end with G are treated as having invalid format.

The swipos-API accepts only durations of up to 6 hours, so all durations must start with PT (period, time), followed by the duration in hours and/or minutes.

If requesting an hour file, it is enough to fill the hour; it is not necessary to give minutes or seconds.

Examples:

• basic format: yyyyMMddThhmmG / 20200821T1313G OR yyyMMddThhG / 20210217T05G
• extended format: yyyy-MM-ddThh:mmG / 2020-08-21T13:13G
• duration (in hours, minutes): PTnHmmM / PT3H30M

As of now, times without the timezone G will not be considered valid times.

Epochs

The RINEX data is recorded at the base station and will be sent every hour to the swipos servers. One hour file contains 3600 epochs if all recordings were successful. An hour file will be available around 20 minutes after the hour has ended.

Please note, that the delivered RINEX files may not contain 100% of the epochs due to recording issues.

Unless otherwise stated, the swipos-API uses latitude and longitude in decimal degrees in the ETRS89 reference system.

Example: 46.28310, 7.53854

Note: The coordinates in the base station information are to be used for representation only, they are not intended for geodetic calculations. The geocentric coordinates contained in the RINEX file as approximate position can be used as precise coordinates.

The delivered RINEX format is 3.04 with 1 second sampling rate as recorded at the base stations (Trimble NetR9 or Leica GR50). To manipulate the RINEX, the RINEX GNSS Data Conversion and Manipulation Toolbox "gfzrnx" is used: Nischan, Thomas (2016): GFZRNX - RINEX GNSS Data Conversion and Manipulation Toolbox. GFZ DataServices

The RINEX files are compressed with hatanaka. The download includes both the observation and navigation files.

The base station is always identified by its 4 character station code, which is case sensitive and must use capital letters, as returned by the /list endpoint.

Example: ZIM2

The swipos-API uses basic authentication for the calls to request-hour and request-data. Any swipos login with a valid swipos-GIS/GEO License can be used with the exception of Pay-per-Use licenses, which are not supported.

The api specification was defined as openapi version 3.0.0 openapi spec.
Here you can find the current developement api specification api-docs.yml.
Here you can find the current productive api specification api-docs.yml.
To generate clients use openapi-generator.

Versioning

Versions are named after plants. Version are alphabetically sorted, where letters later in the alphabet corresnpond with a version published later in time. For minor releases, the second or third letter of the name is significant.

Examples:

• acacia - 1st release
• aconite - 1st minor release
• begonia - 2nd release

swipos-API endpoints that provide RINEX services.