Sign in

Upload Radiosonde Telemetry to Sondehub database.

put/sondes/telemetry

Headers

Datestring date-time required

<day-name>, <day> <month> <year> <hour>:<minute>:<second> UTC as per RFC7231. This is used to calculate receiver time offset for correcting clients that have the incorrect time.

User-Agentstring

The software and version performing the telemetry upload, eg: autorx-1.4.1-beta5

Request body

devstring

If this field is set then the payload will not be uploaded to the database. This is useful for development and testing.

software_namestring required

Name of the decoding software e.g. 'radiosonde_auto_rx', 'dxlAPRS', 'RS41Tracker', 'mySondy'

software_versionstring required

Version of the decoding software e.g. '1.4.0', '20210115'

uploader_callsignstring required

Callsign of the uploader Arbitrary string. Uploader position information and other metadata will be handled separately, but will need to match this callsign to enable calculation of listener statistics.

time_receivedstring date-time required

The time the telemetry packet was received. UTC time in YYYY-MM-DDTHH:MM:SS.SSSSSSZ format.

manufacturer'Vaisala' | 'Graw' | 'Meteomodem' | 'Intermet Systems' | 'Lockheed Martin' | 'Meteo-Radiy' | 'Meteosis' | 'Meisei' required

Radiosonde Manufacturer, as determined from the transmit modulation and high-level packet format.

type'RS41' | 'DFM' | 'M10' | 'M20' | 'iMet-4' | 'iMet-50' | 'iMet-54' | 'LMS6-400' | 'LMS6-1680' | 'MRZ' | 'MTS01' | 'iMS-100' | 'RS-11G' required

The high-level radiosonde model, as can be determined just from the transmit modulation and high-level packet format.

serialstring required

Radiosonde Serial Number. Where possible this should be in the format which matches the sticker/label on the radiosonde itself iMet-1/iMet-4 sondes do not provide a serial number, and so auto_rx generates a serial number based on launch time and transmit frequency. DFM sondes do not regularly transmit their serial number, and so data from these sondes should not be uploaded before the serial number is known.

framenumber required

Frame Number, ideally unique over the entire flight. Should be taken from the telemetry. For some radiosondes (DFM, M10, M20), the datetime (converted to a unix time) is used instead of the provided frame number.

datetimestring date-time required

Date/Time from the sonde's GPS, provided in YYYY-MM-DDTHH:MM:SS.SSSSSSZ format Some sondes (e.g. iMet, LMS6) do not provide the date portion of the timestamp. In this situation, the date portion should be added on by the receiver. An example of how to handle this problem is available here.

latnumber double required

Latitude (decimal degrees)

lonnumber double required

Longitude (decimal degrees)

altnumber double required

Altitude (metres)

subtype'RS41-SG' | 'RS41-SGP' | 'RS41-SGM' | 'DFM06' | 'DFM09' | 'DFM09P' | 'DFM17' | 'M10' | 'M20' | 'MRZ-H1'

Detailed Radiosonde Model Type, as determined through analysis of the telemetry.

frequencynumber float

Transmit frequency of the radiosonde in MHz.

tempnumber float

Measured Temperature (deg C)

humiditynumber float

Measured Relative Humidity (%)

vel_hnumber float

Horizontal Velocity (m/s)

vel_vnumber float

Horizontal Velocity (m/s)

pressurenumber float

Measured Pressure (hPa)

headingnumber float

Heading (degrees True)

battnumber float

Battery Voltage (volts)

satsnumber

Number of SVs used in position solution

xdatastring ascii hex

Auxiliary Data (e.g Ozone data) as a hexadecimal string.

snrnumber float

Signal-to-Noise ratio of the received signal, in dB

rssinumber float

Received-Signal-Strength-Indication of the radiosonde signal, nominally in dBm

uploader_positionnumber[]

Station position, as a list [lat, lon, alt].

uploader_antennastring

Station antenna/receiver information, free-text string.

Response

Telemetry Saved into Database Successfuly

Changes

Changed in 2 of the 31 revisions of this API.2