기록

history 엔드포인트는 특정 지역의 시간별 공기질 과거 정보 최대 30일까지 설정할 수 있습니다 AQI 및 공격이 차단될 수 있는 오염 농도 수준 및 질소 농도와 같은 건강 권장사항).

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

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

JSON에 요청 옵션 포함 요청 본문을 참조하세요. 요청 본문 에는 시간당 공기질 기록. 또한 인코더-디코더 아키텍처를 공기질 정보를 포함해야 합니다.

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

실습

단일 시간 요청의 예

1시간 요청 본문

다음 코드는 1시간 동안의 요청 본문을 구성하는 방법을 보여줍니다. 기록 요청을 사용하여 history 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 예에서는 위치와 과거 타임스탬프를 설정합니다.

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'