Historial

El extremo history proporciona información histórica de la calidad del aire por hora de una ubicación específica, durante un intervalo de tiempo determinado, hasta un máximo de 30 días. Puedes controlar los ICA y la información pertinente que se muestra (como el nivel de concentración de contaminantes y las recomendaciones de salud).

Para solicitar el historial de la calidad del aire por hora con el extremo history, envía una solicitud HTTP POST a la siguiente dirección:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

Incluye tus opciones de solicitud en el cuerpo de la solicitud JSON. El cuerpo de la solicitud contiene la ubicación y el intervalo de tiempo para el que quieres obtener el historial de la calidad del aire por hora. También puede incluir varias opciones para controlar qué información sobre la calidad del aire incluir en la respuesta.

Ejemplo de una solicitud de una hora

Cuerpo de solicitud de una hora

En el siguiente código, se muestra cómo construir un cuerpo de solicitud para una solicitud del historial de una sola hora con el método history. En este ejemplo, se establece la ubicación y la marca de tiempo pasada.

curl -X POST -d '{
  "dateTime": "2023-06-26T15:01:23Z",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

Respuesta de una hora

La llamada anterior genera la siguiente respuesta JSON. Para obtener más detalles sobre los datos de respuesta, consulta Datos de respuesta.

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-26T15:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 73,
                    "aqiDisplay": "73",
                    "color": {
                        "red": 118,
                        "green": 202,
                        "blue": 51,
                        "alpha": 255
                    },
                    "category": "Good air quality",
                    "dominantPollutant": "pm10"
                }
            ]
        }
    ],
    "regionCode": "us"
}

Ejemplo de solicitud de intervalo de tiempo

Solicitud de intervalo de tiempo

En el siguiente código, se muestra cómo construir un cuerpo de solicitud para una history que muestra varios registros de la calidad histórica del aire por hora.

Puedes solicitar varios registros si especificas un intervalo de tiempo (es decir, una marca de tiempo de inicio y finalización), o bien si especificas la cantidad de horas desde la hora actual.

En el siguiente ejemplo, como configuras el tamaño de la página en 2, tu solicitud de cuatro horas del historial de calidad del aire se muestra en dos páginas, y cada una contiene dos horas de datos.

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

Para realizar una solicitud similar, puedes pasar las marcas de tiempo de inicio y finalización:

curl -X POST -d '{
  "period": {
      "startTime":"2023-06-15T08:00:00Z",
      "endTime":"2023-06-15T12:00:00Z"
  },
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

Respuesta del intervalo de tiempo

Las llamadas anteriores generan una respuesta JSON en el siguiente formulario. Para obtener más detalles sobre los datos de respuesta, consulta Datos de respuesta.

Ambas llamadas anteriores solicitan datos de la calidad del aire de cuatro horas. Sin embargo, debido a que configuraste la propiedad pageSize como 2 en la solicitud, la respuesta solo incluye resultados de las dos horas más recientes.

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-15T11:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 83,
                    "aqiDisplay": "83",
                    "color": {
                        "red": 74,
                        "green": 185,
                        "blue": 54,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        },
        {
            "dateTime": "2023-06-15T10:00:00Z",
            "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"
                }
            ]
        }
    ],
    "regionCode": "us",
    "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA"
}

Ten en cuenta que la respuesta también incluye la propiedad nextPageToken. Usa esta propiedad para acceder a la página siguiente de los resultados, que contiene las dos horas de datos siguientes.

Para acceder a la página siguiente de resultados, realiza una segunda solicitud al extremo history, pero esta vez configura la propiedad pageToken en el valor de nextPageToken de la primera respuesta.

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'