Air Quality API
Stay organized with collections
Save and categorize content based on your preferences.
The Air Quality API.
Service: airquality.googleapis.com
To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:
https://airquality.googleapis.com
| Methods |
lookup |
POST /v1/currentConditions:lookup
The Current Conditions endpoint provides hourly air quality information in more than 100 countries, up to a 500 x 500 meters resolution. |
| Methods |
lookup |
POST /v1/forecast:lookup
Returns air quality forecast for a specific location for a given time range. |
| Methods |
lookup |
POST /v1/history:lookup
Returns air quality history for a specific location for a given time range. |
| Methods |
lookupHeatmapTile |
GET /v1/mapTypes/{mapType}/heatmapTiles/{zoom}/{x}/{y}
Returns a bytes array containing the data of the tile PNG image. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[[["\u003cp\u003eThe Air Quality API provides access to current, forecast, and historical air quality data.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can retrieve hourly air quality information for numerous locations worldwide.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers endpoints for querying air quality forecasts and historical records within specific timeframes.\u003c/p\u003e\n"],["\u003cp\u003eIt includes functionality to access heatmap tiles for visualizing air quality data on maps.\u003c/p\u003e\n"],["\u003cp\u003eThe service is accessible through the endpoint \u003ccode\u003ehttps://airquality.googleapis.com\u003c/code\u003e and is best utilized with Google-provided client libraries.\u003c/p\u003e\n"]]],[],null,["# Air Quality API\n\nThe Air Quality API.\n\n- [REST Resource: v1.currentConditions](#v1.currentConditions)\n- [REST Resource: v1.forecast](#v1.forecast)\n- [REST Resource: v1.history](#v1.history)\n- [REST Resource: v1.mapTypes.heatmapTiles](#v1.mapTypes.heatmapTiles)\n\nService: airquality.googleapis.com\n----------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://airquality.googleapis.com`\n\nREST Resource: [v1.currentConditions](/maps/documentation/air-quality/reference/rest/v1/currentConditions)\n----------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [lookup](/maps/documentation/air-quality/reference/rest/v1/currentConditions/lookup) | `POST /v1/currentConditions:lookup` The Current Conditions endpoint provides hourly air quality information in more than 100 countries, up to a 500 x 500 meters resolution. |\n\nREST Resource: [v1.forecast](/maps/documentation/air-quality/reference/rest/v1/forecast)\n----------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| [lookup](/maps/documentation/air-quality/reference/rest/v1/forecast/lookup) | `POST /v1/forecast:lookup` Returns air quality forecast for a specific location for a given time range. |\n\nREST Resource: [v1.history](/maps/documentation/air-quality/reference/rest/v1/history)\n--------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|\n| [lookup](/maps/documentation/air-quality/reference/rest/v1/history/lookup) | `POST /v1/history:lookup` Returns air quality history for a specific location for a given time range. |\n\nREST Resource: [v1.mapTypes.heatmapTiles](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles)\n------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|\n| [lookupHeatmapTile](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile) | `GET /v1/mapTypes/{mapType}/heatmapTiles/{zoom}/{x}/{y}` Returns a bytes array containing the data of the tile PNG image. |"]]
