Skip to content
  • There are no suggestions because the search field is empty.

Air Quality Export Format

MyDataHelps can collect air quality from airnow.gov for each participant. Each sample contains a snapshot of the air quality 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.

See airnow.gov for an explanation of air quality index.

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.

AirQualityIndex

The air quality index at the time the sample was recorded. See AirNow for an explanation of what the numerical values represent.

Type

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

Samples from other postal codes will be named to match the custom field name. For example: WorkPostalCode will have a type of WorkAirQuality

Sample CSV Export

ParticipantIdentifier,Date,PostalCode,AirQualityIndex,Type
aaaa-bbbb-cccc-dddd,2020-09-02T21:58:58+00:00,48887,40,AirQuality
aaaa-bbbb-cccc-dddd,2020-09-02T22:06:49+00:00,30040,70,WorkAirQuality
1111-2222-3333-4444,2020-09-02T22:06:49+00:00,30021,70,AirQuality

Sample JSON Export

{
"ParticipantIdentifier": "aaaa-bbbb-cccc-dddd",
"Date": "2020-09-02T21:58:58+00:00",
"PostalCode": "48887",
"AirQualityIndex": "40",
"Type": "AirQuality"
}
{
"ParticipantIdentifier": "aaaa-bbbb-cccc-dddd",
"Date": "2020-09-02T22:06:49+00:00",
"PostalCode": "30040",
"AirQualityIndex": "70",
"Type": "WorkAirQuality"
}
{
"ParticipantIdentifier": "1111-2222-3333-4444",
"Date": "2020-09-02T22:06:49+00:00",
"PostalCode": "30021",
"AirQualityIndex": "70",
"Type": "AirQuality"
}