Historial

El extremo history proporciona información histórica por hora sobre la calidad del aire en una ubicación específica, durante un período durante un período máximo de 30 días. Puedes controlar qué ICA y la información pertinente (como el nivel de concentración de contaminantes y recomendaciones de salud).

Puedes solicitar un historial de la calidad del aire por hora mediante el history de extremo a través del envío de una solicitud POST de HTTP a la siguiente dirección:

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

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

El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte con la API y las opciones de la API:

Pruébalo

Ejemplo de una solicitud de una sola hora

Cuerpo de la solicitud de una sola hora

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

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 lo 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 un history, que muestra varios de calidad del aire histórica por hora.

Puedes solicitar varios registros especificando un intervalo de tiempo, es decir, un inicio de finalización o de finalización, o especifica el número de horas atrasadas tiempo.

En el siguiente ejemplo, como estableces el tamaño de la página en 2, tu solicitud de se devuelve un historial de cuatro horas de calidad del aire en dos páginas, donde cada página 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, pasa 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'

Intervalo de tiempo de respuesta

Las llamadas anteriores generan un Respuesta JSON en el formulario a continuación. Para obtener más detalles sobre los datos de respuesta, consulta Datos de respuesta.

Las dos llamadas anteriores solicitan datos de la calidad del aire de cuatro horas. Sin embargo, como estableces la propiedad pageSize a 2 en la solicitud, la respuesta solo incluye resultados de las últimas dos horas.

{
    "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. Usar esta para acceder a la página siguiente de los resultados, que contiene las dos horas de datos.

Para acceder a la siguiente página de resultados, realiza una segunda solicitud a la extremo history, pero esta vez establece 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'