history 엔드포인트는 지정된 기간(최대 30일) 동안 특정 위치의 시간별 과거 공기질 정보를 제공합니다. 반환되는 AQI 및 관련 정보 (예: 오염 농도 수준, 건강 권장사항)를 제어할 수 있습니다.
HTTP POST 요청을 다음으로 전송하여 history 엔드포인트를 사용하여 시간당 공기질 내역을 요청할 수 있습니다.
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
JSON 요청 본문에 요청 옵션을 포함합니다. 요청 본문에는 시간당 공기질 기록을 가져올 위치와 기간이 포함됩니다. 또한 응답에 포함할 공기질 정보를 제어하는 다양한 옵션이 포함될 수 있습니다.
단일 시간 요청의 예
1시간 요청 본문
다음 코드는 history 메서드를 사용하여 1시간 기록 요청의 요청 본문을 구성하는 방법을 보여줍니다.
이 예에서는 위치와 과거 타임스탬프를 설정합니다.
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'
1시간 응답
위 호출을 수행하면 다음과 같은 JSON 응답이 생성됩니다. 응답 데이터에 대한 자세한 내용은 응답 데이터를 참고하세요.
{
"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"
}
기간 요청의 예
기간 요청
다음 코드는 과거 시간당 공기질 기록을 여러 개 반환하는 history의 요청 본문을 구성하는 방법을 보여줍니다.
시간 범위(예: 시작 및 종료 타임스탬프)를 지정하거나 현재 시간부터의 시간 수를 지정하여 여러 레코드를 요청할 수 있습니다.
아래 예에서는 페이지 크기를 2로 설정했으므로 4시간 동안의 공기질 기록 요청이 두 페이지에 반환되며 각 페이지에 2시간의 데이터가 포함됩니다.
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'
시작 및 종료 타임스탬프를 전달하여 유사한 요청을 할 수 있습니다.
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'
기간 응답
위 호출을 실행하면 아래 형식의 JSON 응답이 생성됩니다. 응답 데이터에 관한 자세한 내용은 응답 데이터를 참고하세요.
위의 두 통화 모두 4시간 동안의 공기질 데이터를 요청합니다. 그러나 요청에서 pageSize 속성을 2로 설정했으므로 응답에 최근 두 시간 동안의 결과만 포함됩니다.
{
"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"
}
응답에는 nextPageToken 속성도 포함됩니다. 이 속성을 사용하여 다음 2시간 분량의 데이터가 포함된 결과의 다음 페이지에 액세스합니다.
결과의 다음 페이지에 액세스하려면 history 엔드포인트에 두 번째 요청을 실행합니다. 단, 이번에는 pageToken 속성을 첫 번째 응답의 nextPageToken 값으로 설정합니다.
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'