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:
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'