Le point de terminaison de prévision fournit jusqu'à 96 heures (4 jours) d'informations de prévision sur la qualité de l'air par heure pour un lieu donné. Chaque prévision comprend des indices horaires sur la qualité de l'air ainsi que des informations supplémentaires:
- Date et heure spécifiques, ou période pour la prévision
- Code de langue pour les champs traduits
- Indice de la qualité de l'air (IQA) local ou personnalisé
- Recommandations de santé
- Polluants dominants
- Concentration du polluant
- Informations supplémentaires sur les polluants
- Taille de la page de réponse
- Palette de couleurs
À propos des demandes de prévision
Vous pouvez demander des informations sur les prévisions horaires de la qualité de l'air à l'aide du point de terminaison de prévision en envoyant une requête HTTP POST à:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
Incluez vos paramètres dans le corps de la requête. Le corps de la requête contient le lieu pour lequel vous souhaitez obtenir des informations sur la qualité de l'air des prévisions horaires, ainsi que diverses options pour contrôler les informations supplémentaires à inclure dans la réponse.
À propos des réponses aux prévisions
Le corps de la réponse fournit la date et l'heure UTC pour lesquelles afficher des informations sur les prévisions de qualité de l'air, des indices de qualité de l'air et des informations personnalisées supplémentaires. Le corps de la réponse inclut également un jeton permettant de récupérer la page suivante si les informations ne correspondent pas à la taille de page demandée.
Exemple de requête de base
Le code suivant montre comment créer une demande de prévision. Dans cet exemple, vous spécifiez le lieu, la date et l'heure (à partir de l'heure suivante, jusqu'à 96 heures) pour lesquels vous souhaitez afficher des informations sur les prévisions de qualité de l'air par heure.
curl -X POST -d '{
"location": {
"latitude": 37.4125333,
"longitude": -122.0840937
},
"dateTime": "2024-02-09T08:00:00Z"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
L'appel génère la réponse JSON suivante.
{
"hourlyForecasts": [
{
"dateTime": "2024-02-09T08:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 80,
"aqiDisplay": "80",
"color": {
"red": 0.34509805,
"green": 0.74509805,
"blue": 0.20784314
},
"category": "Excellent air quality",
"dominantPollutant": "pm25"
}
]
}
],
"regionCode": "us"
}
Exemple de requête avec plusieurs paramètres
Le code suivant montre comment construire un corps de requête avec plusieurs paramètres. Dans cet exemple, vous spécifiez ce qui suit:
- Emplacement
- Période pour laquelle afficher les prévisions sur la qualité de l'air
- Code de langue
- Méthodes de calcul supplémentaires (recommandations pour la santé, concentration du polluant dominant et autres informations sur les polluants)
- Palette de couleurs
curl -X POST -d '{
"pageSize": "10",
"universalAqi": "true",
"location": {
"latitude": "40.741895",
"longitude": "-73.989308"
},
"period": {
"startTime": "2024-02-27T13:58:14+02:00",
"endTime": "2024-02-28T16:58:14+02:00"
},
"languageCode": "en",
"extraComputations": [
"HEALTH_RECOMMENDATIONS",
"DOMINANT_POLLUTANT_CONCENTRATION",
"POLLUTANT_ADDITIONAL_INFO"
],
"uaqiColorPalette": "RED_GREEN"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
L'appel génère la réponse JSON suivante.
{
{
"hourlyForecasts": [
{
"dateTime": "2024-02-27T11:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 75,
"aqiDisplay": "75",
"color": {
"red": 0.43137255,
"green": 0.7764706,
"blue": 0.20392157
},
"category": "Good air quality",
"dominantPollutant": "pm25"
}
],
"pollutants": [
{
"code": "pm25",
"displayName": "PM2.5",
"fullName": "Fine particulate matter (\u003c2.5µm)",
"concentration": {
"value": 15.1,
"units": "MICROGRAMS_PER_CUBIC_METER"
},
"additionalInfo": {
"sources": "...",
"effects": "..."
}
}
],
"healthRecommendations": {
"generalPopulation": "...",
"lungDiseasePopulation": "...",
"heartDiseasePopulation": "...",
"athletes": "...",
"pregnantWomen": "..."
}
},
{
"dateTime": "2024-02-27T12:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 67,
"aqiDisplay": "67",
"color": {
"red": 0.5882353,
"green": 0.8392157,
"blue": 0.16862746
},
"category": "Good air quality",
"dominantPollutant": "pm25"
}
],
"pollutants": [
{
"code": "pm25",
"displayName": "PM2.5",
"fullName": "Fine particulate matter (\u003c2.5µm)",
"concentration": {
"value": 19.96,
"units": "MICROGRAMS_PER_CUBIC_METER"
},
"additionalInfo": {
"sources": "...",
"effects": "..."
}
}
],
"healthRecommendations": {
"generalPopulation": "...",
"lungDiseasePopulation": "...",
"heartDiseasePopulation": "...",
"athletes": "...",
"pregnantWomen": "...",
"children": "..."
}
},
/.../
]
}
"regionCode": "us",
"nextPageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}
Pour afficher la page suivante d'informations de prévision, transmettez le nextPageToken renvoyé à la fin du corps de la réponse:
curl -X POST -d '{
"universalAqi": "true",
"location": {
"latitude": "40.741895",
"longitude": "-73.989308"
},
"period": {
"startTime": "2024-02-27T13:58:14+02:00",
"endTime": "2024-02-28T16:58:14+02:00"
},
"languageCode": "en",
"extraComputations": [
"HEALTH_RECOMMENDATIONS",
"DOMINANT_POLLUTANT_CONCENTRATION",
"POLLUTANT_ADDITIONAL_INFO"
],
"uaqiColorPalette": "RED_GREEN",
"pageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
La page suivante d'informations de prévision s'affiche:
{
"hourlyForecasts": [
{
"dateTime": "2024-02-27T21:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 74,
"aqiDisplay": "74",
"color": {
"red": 0.44705883,
"green": 0.78431374,
"blue": 0.2
},
"category": "Good air quality",
"dominantPollutant": "o3"
}
],
"pollutants": [
{
"code": "o3",
"displayName": "O3",
"fullName": "Ozone",
"concentration": {
"value": 32.07,
"units": "PARTS_PER_BILLION"
},
"additionalInfo": {
"sources": "...",
"effects": "..."
}
}
],
"healthRecommendations": {
"generalPopulation": "...",
"elderly": "...",
"lungDiseasePopulation": "...",
"heartDiseasePopulation": "...",
"athletes": "...",
"pregnantWomen": "...",
"children": "..."
}
},
{
"dateTime": "2024-02-27T22:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 75,
"aqiDisplay": "75",
"color": {
"red": 0.43137255,
"green": 0.7764706,
"blue": 0.20392157
},
"category": "Good air quality",
"dominantPollutant": "o3"
}
],
"pollutants": [
{
"code": "o3",
"displayName": "O3",
"fullName": "Ozone",
"concentration": {
"value": 30.94,
"units": "PARTS_PER_BILLION"
},
"additionalInfo": {
"sources": "...",
"effects": "..."
}
}
],
"healthRecommendations": {
"generalPopulation": "...",
"lungDiseasePopulation": "...",
"heartDiseasePopulation": "...",
"athletes": "...",
"pregnantWomen": "...",
"children": "..."
}
},
/.../
]
"regionCode": "us"
}