Skip to main content

Weather Export Format

  • Updated

MyDataHelps can collect weather forecast data from weatherbit.io for each participant. Each sample contains data for the 24-hour weather forecast for the indicated postal code. If the project has Custom Fields with names ending in "PostalCode" (e.g. WorkPostalCode or SchoolPostalCode), there will be one daily sample for each postal code.

Table of Contents

Data Fields

Field Description
ParticipantIdentifier The MyDataHelps identifier of the participant. Can be used to cross reference with Participants.
ParticipantID
 		The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
Date The date the sample was recorded, in ISO 8601 format.
PostalCode

The postal code for which data was recorded.
Type

Samples from their home postal code will have a type of WeatherData.

Samples from other postal codes will be named to match the custom field name. For example: WorkPostalCode will have a type of WorkWeatherData.
LowTemperature The expected low temperature (in degrees Fahrenheit) using a 6AM to 6AM meteorological day.
HighTemperature The expected high temperature (in degrees Fahrenheit) using a 6AM to 6AM meteorological day.
MinTemperature The minimum temperature (in degrees Fahrenheit) expected in the next 24 hours.
MaxTemperature The maximum temperature (in degrees Fahrenheit) expected in the next 24 hours.
LiquidEquivalentPrecipitation Expected rain or equivalent precipitation (in inches).
SnowAccumulation Expected snow accumulation (in inches).
ProbabilityOfPrecipitation Probability of there being precipitation in the next 24 hours (as a %).

Sample CSV Export

ParticipantIdentifier,Date,PostalCode,Type,LowTemperature,HighTemperature,MinTemperature,MaxTemperature,LiquidEquivalentPrecipitation,SnowAccumulation,ProbabilityOfPrecipitation
aaaa-bbbb-cccc-dddd,2020-09-02T14:09:10+00:00,48887,PostalCode,49.3,82.9,56,83.3,0.347,0,75
aaaa-bbbb-cccc-dddd,2020-09-03T14:09:10+00:00,48886,WorkPostalCode,49.3,82.9,56,83.3,0.347,0,75
1111-2222-3333-4444,2020-09-03T14:09:10+00:00,48887,PostalCode,49.3,82.9,56,83.3,0,0,0

Sample JSON Export

{
  "ParticipantIdentifier": "aaaa-bbbb-cccc-dddd",
  "Date": "2020-09-02T20:19:09+00:00",
  "PostalCode": "48887",
  "Type": "PostalCode",
  "LowTemperature": "56.8",
  "HighTemperature": "77.4",
  "MinTemperature": "62.6",
  "MaxTemperature": "78.5",
  "LiquidEquivalentPrecipitation": "0.347",
  "SnowAccumulation": "0",
  "ProbabilityOfPrecipitation": "75"
}
{
  "ParticipantIdentifier": "aaaa-bbbb-cccc-dddd",
  "Date": "2020-09-03T20:19:09+00:00",
  "PostalCode": "48886",
  "Type": "WorkPostalCode",
  "LowTemperature": "56.8",
  "HighTemperature": "77.4",
  "MinTemperature": "62.6",
  "MaxTemperature": "78.5",
  "LiquidEquivalentPrecipitation": "0",
  "SnowAccumulation": "0",
  "ProbabilityOfPrecipitation": "0"
}
{
  "ParticipantIdentifier": "1111-2222-3333-4444",
  "Date": "2020-09-03T20:19:09+00:00",
  "PostalCode": "48887",
  "LowTemperature": "56.8",
  "HighTemperature": "77.4",
  "MinTemperature": "62.6",
  "MaxTemperature": "78.5",
  "LiquidEquivalentPrecipitation": "0",
  "SnowAccumulation": "0",
  "ProbabilityOfPrecipitation": "0"
}

Was this article helpful?