history 엔드포인트는 특정 위치의 시간별 공기질 정보를 특정 기간(최대 30일) 동안 제공합니다. 반환되는 AQI 및 관련 정보 (예: 오염 물질 농도 수준, 건강 권장사항)를 제어할 수 있습니다.
다음 주소로 HTTP POST 요청을 전송하여 history 엔드포인트를 사용하여 시간별 공기질 기록을 요청할 수 있습니다.
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
JSON 요청 본문에 요청 옵션을 포함합니다. 요청 본문에는 시간별 공기질 기록을 가져올 위치와 시간 범위가 포함됩니다. 응답에 포함할 공기질 정보를 제어하는 다양한 옵션도 포함될 수 있습니다.
API 탐색기를 사용하면 API 및 API 옵션을 익히기 위해 실시간으로 요청할 수 있습니다.
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페이지로 반환되며 각 페이지에는 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로 설정했으므로 응답에는 최근 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'