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'