Air Quality Forecast API Request

BreezoMeter Air Quality Forecast API requests are very similar to our historical API requests
and are straightforward and simple to use.
Forecast API calls can provide:

  • Air quality data forecasts for a specific location for the next 24 hours
  • Air quality forecast data for a range of dates at a specific location for up to four days

We use the date and time format ISO 8601 standard for our timestamp. The standard is represented as:
YYYY-MM-DDTHH:mm:SS

Forecast API queries are priced as API calls, returning 24 objects per request and priced individually per object depending on the length of the time interval queried, which affects the number of data objects returned. Each returned data object (maximum one per hour) is priced as one API call.
e.g. The maximum price for each forecast API query equivalent Forecast API call will be: 4 days * 24 hour * API call price.


Ready to learn more?

Discuss your project and needs, learn more about pricing and ask any questions:

Get in touch with our team


Air Quality Forecast Data for the next 24-96 Hours

You can get forecast air quality data for the next 24 hours in a specific location (latitude and longitude) by concatenating the following API request:
https://api.breezometer.com/forecast/?lat={latitude}&lon={longitude}&key=YOUR_API_KEY

Required parameters:

  • Location
    • lat Latitude is a geographic coordinate that specifies the North-South position of a point on the Earth’s surface. Range between -90 to 90 (WGS84 standard)
    • lon Longitude is a geographic coordinate that specifies the East-West position of a point on the Earth’s surface. Range between -180 to 180 (WGS84 standard)
  • keyYour BreezoMeter API key. This key identifies your account for the purpose of quota management and features access.

optional:

  • hours – hours represents the period of time for the Forecast data you’ll receive.
    You can choose any value (integer) up to 96 hours.
    24 hours is the default period of time if you don’t use the ‘hours’ parameter.
  • lang – Response language. We support English(“en”) and Hebrew(“he”).

Responses:

The responses are returned in JSON format.
For example, the BreezoMeter Forecast Air Quality Data for the next 48 Hours response for the query on “Latitude=40.7324296, Longitude=-73.9977264” and “hours=48”.

This request demonstrates:

https://api.breezometer.com/forecast/?lat=40.7324296&lon=-73.9977264&hours=48&key=YOUR_API_KEY

The response:

Air Quality Forecast Data for a range of dates of up to four days

You can acquire Air Quality Forecast Data for a range of dates at a specific location (latitude and longitude) with start and end timestamps that will provide an array of results. The end date should be up to four days from the time the API request is made.

To get air quality data for a range of dates at a given location you need to concatenate the following API request:

https://api.breezometer.com/forecast/?start_datetime={the_required_start_date}&end_datetime={the_required_end_date}&lat={latitude}&lon={longitude}&key=YOUR_API_KEY

Required parameters:

  • start_datetime – The specific start time that you wish to receive air quality data for.
  • end_datetime – The specific end time you wish to receive air quality data for.
  • Location
    • latLatitude is a geographic coordinate that specifies the North-South position of a point on the Earth’s surface. Range between -90 to 90 (WGS84 standard)
    • lonLongitude is a geographic coordinate that specifies the East-West position of a point on the Earth’s surface. Range between -180 to 180 (WGS84 standard)
  • keyYour BreezoMeter API key. This key identifies your account for the purpose of quota management and features access.

optional:

  • lang – Response language. We support English(“en”) and Hebrew(“he”).

Responses:

The responses are returned in JSON format.

For example, the BreezoMeter Forecast Air Quality Data for a range of dates in response to the query on “start_datetime={{vm.form.start_datetime}}”, “end_datetime={{vm.form.end_datetime}}” and “Latitude=40.7324296, Longitude=-73.9977264”.

This request demonstrates:

{{vm.baseUrl}}?lat={{vm.form.lat}}&lon={{vm.form.lon}}&start_datetime={{vm.form.start_datetime}}&end_datetime={{vm.form.end_datetime}}&key={{vm.form.key}}

Try a range dates call

e.g The next 24 hours

Start Date {{vm.form.start_datetime}} - End Date {{vm.form.end_datetime}}

Start Date

End Date

{{vm.baseUrl}}?lat={{vm.form.lat}} &lon={{vm.form.lon}}&start_datetime={{vm.form.start_datetime}}&end_datetime={{vm.form.end_datetime}}&key={{vm.form.key}}