Air Quality Export Format
- Updated
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.
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. |
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"
}
Was this article helpful?