Le point de terminaison currentConditions fournit des informations sur la qualité de l'air actuelles, heure par heure. Vous pouvez contrôler les IQA et les informations pertinentes renvoyées (telles que le niveau de concentration des polluants et les recommandations de santé).
Vous pouvez demander la qualité de l'air actuelle par heure à l'aide du point de terminaison currentConditions en envoyant une requête HTTP POST à l'adresse:
https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY
Incluez vos options de requête dans le corps de la requête JSON. Le corps de la requête contient l'emplacement pour lequel vous souhaitez obtenir les conditions actuelles de qualité de l'air et diverses options pour contrôler les informations sur la qualité de l'air à inclure dans la réponse.
APIs Explorer vous permet d'effectuer des requêtes en temps réel afin de vous familiariser avec l'API et ses options:
Exemple de requête de base
Corps de requête de base
Le code suivant montre comment créer un corps de requête de base pour une requête currentConditions. Dans cet exemple, vous ne définissez que l'emplacement.
curl -X POST -d '{
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'
Réponse de base à la requête
L'appel ci-dessus génère la réponse JSON suivante. Pour en savoir plus sur les données de réponse, consultez Données de réponse.
{
"dateTime": "2023-10-26T18:00:00Z",
"regionCode": "us",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 52,
"aqiDisplay": "52",
"color": {
"red": 0.9490196,
"green": 0.98039216,
"blue": 0.019607844
},
"category": "Moderate air quality",
"dominantPollutant": "no2"
}
]
}
Exemple de requête avec plusieurs paramètres
Requête avec plusieurs paramètres
Le code suivant montre comment créer un corps de requête pour une requête currentConditions.
Dans cet exemple, en plus de l'emplacement, plusieurs calculs supplémentaires et la langue de la réponse sont spécifiés.
curl -X POST -d '{
"universalAqi": true,
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
},
"extraComputations": [
"HEALTH_RECOMMENDATIONS",
"DOMINANT_POLLUTANT_CONCENTRATION",
"POLLUTANT_CONCENTRATION",
"LOCAL_AQI",
"POLLUTANT_ADDITIONAL_INFO"
],
"languageCode": "en"
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'
Réponse à plusieurs paramètres
L'appel ci-dessus génère la réponse JSON suivante. Pour en savoir plus sur les données de réponse, consultez Données de réponse.
{
"dateTime": "2023-06-15T10:00:00Z",
"regionCode": "us",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 89,
"aqiDisplay": "89",
"color": {
"red": 48,
"green": 175,
"blue": 55,
"alpha": 255
},
"category": "Excellent air quality",
"dominantPollutant": "o3"
},
{
"code": "usa_epa",
"displayName": "AQI (US)",
"aqi": 41,
"aqiDisplay": "41",
"color": {
"green": 228,
"alpha": 255
},
"category": "Good air quality",
"dominantPollutant": "pm25"
}
],
"pollutants": [
{
"code": "co",
"displayName": "CO",
"fullName": "Carbon monoxide",
"concentration": {
"value": 334.24,
"units": "PARTS_PER_BILLION"
},
"additionalInfo": {
"sources": "Typically originates from incomplete combustion...",
"effects": "When inhaled, carbon monoxide can prevent the blood from..."
}
},
{
"code": "no2",
"displayName": "NO2",
"fullName": "Nitrogen dioxide",
"concentration": {
"value": 13.12,
"units": "PARTS_PER_BILLION"
},
"additionalInfo": {
"sources": "Main sources are fuel burning processes, such as...",
"effects": "Exposure may cause increased bronchial reactivity..."
}
},
{
"code": "o3",
"displayName": "O3",
"fullName": "Ozone",
"concentration": {
"value": 13.88,
"units": "PARTS_PER_BILLION"
},
"additionalInfo": {
"sources": "Ozone is created in a chemical reaction between atmospheric oxygen...",
"effects": "Ozone can irritate the airways and cause coughing, a burning..."
}
},
{
"code": "pm10",
"displayName": "PM10",
"fullName": "Inhalable particulate matter (<10µm)",
"concentration": {
"value": 5.07,
"units": "MICROGRAMS_PER_CUBIC_METER"
},
"additionalInfo": {
"sources": "Main sources are combustion processes (e.g. indoor heating, wildfires)...",
"effects": "Inhalable particles can penetrate into the lungs. Short term exposure..."
}
},
{
"code": "pm25",
"displayName": "PM2.5",
"fullName": "Fine particulate matter (<2.5µm)",
"concentration": {
"value": 2.83,
"units": "MICROGRAMS_PER_CUBIC_METER"
},
"additionalInfo": {
"sources": "Main sources are combustion processes (e.g. power plants, indoor heating...",
"effects": "Fine particles can penetrate into the lungs and bloodstream. Short term..."
}
},
{
"code": "so2",
"displayName": "SO2",
"fullName": "Sulfur dioxide",
"concentration": {
"value": 0.02,
"units": "PARTS_PER_BILLION"
},
"additionalInfo": {
"sources": "Main sources are burning processes of sulfur-containing fuel in industry...",
"effects": "Exposure causes irritation of the respiratory tract, coughing and generates..."
}
}
],
"healthRecommendations": {
"generalPopulation": "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...",
"lungDiseasePopulation": "...",
"heartDiseasePopulation": "...",
"athletes": "...",
"pregnantWomen": "...",
"children": "..."
}
}