In this article, I will provide a clear explanation of the object table and JSON output of the BreezoMeter air quality API. As a programmer, you may already be familiar with these terms, but understanding how they specifically apply to the BreezoMeter API can be crucial for efficiently working with the data it provides. By the end of this article, you should have a solid understanding of the structure and content of the object table and JSON output provided by BreezoMeter.

Object and Description table

1. datetime: This object represents the date and time at which the air quality data was recorded. The timestamp is given in ISO 8601 format and is expressed in UTC time.

2. data_available: This object is a boolean that indicates whether the requested air quality data is available.

3. indexes: This object is a dictionary that contains two air quality indexes: the BreezoMeter AQI (baqi) and the Local AQI set to be the default index for the requested location (country). The BreezoMeter AQI is a score that represents the overall air quality in a particular location based on various pollutants. The Local AQI is a score that is set by the local government or air quality agency in the requested location.

4. display_name: This object is a string that represents the name of the index.

5. aqi: This object is a numeric score that represents the air quality index.

6. aqi_display: This object is a string that provides a textual representation of the index numeric score. It may include prefix or suffix symbols that usually represent the worst index score.

7. color: This object is a hexadecimal color code that represents the index numeric score.

8. category: This object is a string that provides a textual interpretation of the index numeric score.

9. dominant_pollutant: This object is a string that represents the pollutant code of the dominant pollutant.

10. pollutants: This object is a dictionary that contains information about the available pollutants at the requested location.

11. health_recommendations: This object is a dictionary that contains BreezoMeter health advice and recommended actions related to the reported air quality conditions. The recommendations are tailored for at-risk populations and groups with greater sensitivities to pollutants than the general population.

12. general_population: This object is a string that indicates that there are no specific sensitivities related to the air quality conditions for the general population.

13. elderly: This object is a string that indicates that retirees and people older than the general population may be more sensitive to the reported air quality conditions.

14. lung_diseases: This object is a string that indicates that people with respiratory-related problems and asthma sufferers may be more sensitive to the reported air quality conditions.

15. heart_diseases: This object is a string that indicates that people with heart and circulatory system diseases may be more sensitive to the reported air quality conditions.

16. active: This object is a string that indicates that people engaging in sports and other strenuous outdoor activities may be more sensitive to the reported air quality conditions.

17. pregnant_women: This object is a string that indicates that women at all stages of pregnancy may be more sensitive to the reported air quality conditions.

18. children: This object is a string that indicates that younger populations, including children, toddlers, and babies, may be more sensitive to the reported air quality conditions.

The information in the table is useful for anyone who wants to work with air quality data using the BreezoMeter air quality API. By understanding the objects and their descriptions, programmers can efficiently access and manipulate the data provided by the API to build applications that consume and display air quality information to end-users. The table provides a comprehensive overview of the available objects, which can serve as a reference guide for developers working with the API. Additionally, the detailed descriptions of each object allow developers to make informed decisions about how to use the data in their applications, based on the specific needs and requirements of their use case. Overall, the information in the table is a valuable resource for developers looking to incorporate air quality data into their software applications using the BreezoMeter API.

Clarifying JSON output

This is a JSON output that contains air quality data retrieved using the BreezoMeter air quality API. The output has four main objects: metadata, data, pollutants, and health_recommendations. The metadata object is null, indicating that no metadata is available. The data object contains information about the air quality at a specific date and time, including the date and time stamp, a boolean indicating whether the data is available, and indexes that represent the overall air quality at the requested location. The pollutants object contains information about various pollutants in the air, including carbon monoxide, nitrogen oxides, ozone, and particulate matter. The health_recommendations object provides tailored advice on how to protect one's health based on the reported air quality conditions. It includes advice for the general population, elderly individuals, those with lung and heart diseases, pregnant women, active individuals, and children. The error object is null, indicating that no errors occurred during the API request.

"metadata"
:
null
,
"data"
:
{
"datetime"
:
"2022-11-27T18:00:00Z"
,
"data_available"
:
true
,
"indexes"
:
{
"baqi": { /* 6 items / }
,
"fra_atmo": { / 6 items / }
}
,
"pollutants"
:
{
"co": { / 5 items / }
,
"no": { / 5 items / }
,
"no2": { / 5 items / }
,
"nox": { / 5 items / }
,
"o3": { / 5 items / }
,
"pm10": { / 5 items / }
,
"pm25": { / 5 items / }
,
"so2": { / 5 items */ }
}
,
"health_recommendations"
:
{
"general_population"
:
"With this level of air quality, you have no limitations. Enjoy the outdoors!"
,
"elderly"
:
"If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider reducing the intensity of your outdoor activities. Try to limit the time you spend near busy roads, construction sites, open fires and other sources of smoke."
,
"lung_diseases"
:
"If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider reducing the intensity of your outdoor activities. Try to limit the time you spend near busy roads, industrial emission stacks, open fires and other sources of smoke."
,
"heart_diseases"
:
"If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider reducing the intensity of your outdoor activities. Try to limit the time you spend near busy roads, construction sites, industrial emission stacks, open fires and other sources of smoke."
,
"active"
:
"If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider reducing the intensity of your outdoor activities. Try to limit the time you spend near busy roads, construction sites, industrial emission stacks, open fires and other sources of smoke."
,
"pregnant_women"
:
"To keep you and your baby healthy, consider reducing the intensity of your outdoor activities. Try to limit the time you spend near busy roads, construction sites, open fires and other sources of smoke."
,
"children"
:
"If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider reducing the intensity of your outdoor activities. Try to limit the time you spend near busy roads, construction sites, open fires and other sources of smoke."
}
}
,
"error"
:
null
}

In summary

In this article today, we discussed the BreezoMeter air quality API and the objects included in its JSON output. We started by clarifying the meaning of an object table and JSON output and then provided a detailed description of the various objects in the table. We also explained why the information in the table is useful for programmers who want to work with air quality data. Lastly, we examined an example JSON output retrieved from the BreezoMeter API, which provided information on the air quality at a specific date and time, pollutants in the air, and health recommendations. Overall, this conversation provided an overview of the BreezoMeter air quality API and its JSON output, as well as insights into the value of air quality data for software development.

Source

You can request access to the BreezoMeter air quality API through the third-party data marketplace of WorldInData. WorldInData is a data marketplace that offers access to a wide range of datasets and APIs, including the BreezoMeter air quality API. To gain access to the API, you can create an account on the WorldInData platform and request access to the BreezoMeter API. Once your request is approved, you will receive an API key that you can use to make requests to the BreezoMeter API and retrieve air quality data. The WorldInData platform provides a streamlined process for gaining access to the BreezoMeter API and other data sources, making it an excellent resource for developers and researchers who need access to high-quality data.

##