기록

history 엔드포인트는 특정 지역의 시간별 공기질 과거 정보 최대 30일까지 설정할 수 있습니다 반환되는 AQI 및 관련 정보(예: 오염 물질 농도 수준, 건강 권장사항)를 제어할 수 있습니다.

다음을 사용하여 시간별 공기질 기록을 요청할 수 있습니다. history 드림 엔드포인트 간 HTTP POST 요청을 전송합니다.

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

JSON에 요청 옵션 포함 요청 본문을 참조하세요. 요청 본문 에는 시간당 공기질 기록. 또한 광고를 게재하기 위한 공기질 정보를 포함해야 합니다.

API 탐색기를 사용하면 실시간 요청을 통해 다음과 같습니다.

실습

단일 시간 요청의 예

단일 시간 요청 본문

다음 코드는 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시간 분량의 공기질 기록이 두 페이지로 반환되며 각 페이지는 두 시간 분량의 데이터가 포함되어 있습니다.

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 속성도 포함되어 있습니다. 사용 속성을 사용하여 다음 두 개의 결과가 포함된 다음 결과 페이지에 액세스합니다. 100%에 가까운 속도로 데이터가 수집됩니다

결과의 다음 페이지에 액세스하려면 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'