El extremo de previsión proporciona hasta 96 horas (4 días) de aire por hora información de previsión de calidad para una ubicación determinada. Cada previsión incluye datos por hora y también información adicional:
- Una hora, fecha o período específicos para la previsión
- Código de idioma para campos traducidos
- Índice de calidad del aire (ICA) local o personalizado
- Recomendaciones de salud
- Contaminantes dominantes
- Concentración de contaminante
- Información adicional sobre los contaminantes
- Tamaño de la página de respuesta
- Paleta de colores
Acerca de las solicitudes de previsión
Puedes solicitar información sobre la previsión de la calidad del aire por hora mediante el previsión de un extremo mediante el envío de una solicitud POST HTTP al siguiente destino:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
Incluye tu parámetros en el cuerpo de la solicitud. El cuerpo de la solicitud contiene la ubicación para la que información sobre el pronóstico por hora de la calidad del aire y varias opciones para y controlar qué información adicional incluir en la respuesta.
Acerca de las respuestas de previsión
El cuerpo de la respuesta proporciona la fecha y hora UTC para las cuales se mostrarán información sobre pronósticos de calidad, índices de calidad del aire y datos información. El cuerpo de la respuesta también incluye un token para recuperar la página siguiente si la información no se ajusta al tamaño de la página solicitado.
Ejemplo de solicitud básica
En el siguiente código, se muestra cómo crear una solicitud de previsión. En este ejemplo, especificas la ubicación, fecha y hora (a partir de la próxima hora hasta 96 horas) para mostrar información sobre el pronóstico de la calidad del aire por hora.
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"
La llamada genera la siguiente respuesta JSON.
{
"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"
}
Ejemplo de solicitud con varios parámetros
En el siguiente código, se muestra cómo construir un cuerpo de solicitud con varios parámetros. En este ejemplo, especifica lo siguiente:
- Ubicación
- Período para el cual se debe mostrar información sobre la previsión de la calidad del aire
- Código de idioma
- Cálculos adicionales (como recomendaciones de salud, el contaminante dominante concentración e información adicional sobre los contaminantes)
- Paleta de colores
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"
La llamada genera la siguiente respuesta JSON.
{
{
"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=="
}
Para ver la siguiente página de información de previsión, pasa nextPageToken.
que se muestra al final del cuerpo de la respuesta:
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"
Esto devuelve la siguiente página de información de previsión:
{
"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"
}