GetRegionAirthority

An Airthority (Confidence) Map

The Airthority API provides a map representing a confidence rating of the likely correlation between the airborne allergen concentration data provided by our other APIs, and human health. The information is region specific and is returned as a geoTIFF raster map with floating point values for each grid segment in the region. This API is not a mapping service in the sense of generating sub-tiles with varying styles for the purpose of rendering end-user maps.

NOTE: this is not to be used in any critical health-care application. No warranty is given. These data are to be regarded only as informative.

Use Cases

  • Integration into an analytical model relating to human health and allergies.
  • Determining whether alerts or push notifications should be sent to users based on reported conditions.
  • Estimating the most effective spend for allergy related advertisement.

Understanding the Values

The values range from 0, indicating the lowest confidence in correlation, to 1, indicating the highest confidence of correlation based on Pollen Sense's research.

  • A value 0.25 and below should be considered only to have a long-term (seasonal) correlation.
  • A value of 0.75 and above should be considered likely to have good correlation with human health. We leave it to your descretion as to what thresholds to use for various applications. Allergies differ from person to person, so this data should not be assumed to correlate on an individual basis, and again: no warranty is given regarding this data.

These data represent a combination of sensor proximity, inference/interpolation relating to climatological similarity, as well other objective and subjective information. As our network of sensors increases, and our modelling becomes more sophisticated, we expect the areas of high-confidence to grow. We will do our best to maintain an evidence-based basis for the data.

Data Availability Policy

These maps are generated on a per-day basis, though only for observations. They do, however, apply to forecasts in that the forecast should scale in confidence based on the confidence of the most recent Airthority map.

Query Parameters
  • region
    Type: string
    required

    A region code, such as NA for North America

  • starting
    Type: stringFormat: date-time
    required

    Starting date relative to region time . Use ISO format, e.g: YYYY-MM-DD NOTE: these maps are only available daily, and only historically (yesterday and back).

Responses
  • image/tiff
Request Example for get/airthority
curl 'https://model.pollensense.com/api/airthority?region=NA&starting=&key=YOUR_SECRET_TOKEN'
string