Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

방문 기록

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

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

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시간 분량의 데이터가 포함됩니다.

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'

기능을 사용해 보세요.

API 탐색기를 사용하면 샘플 요청을 수행하여 API 및 API 옵션에 익숙해질 수 있습니다.

페이지 오른쪽에서 API 아이콘 api를 선택합니다.
필요한 경우 요청 파라미터를 수정합니다.
실행 버튼을 선택합니다. 대화상자에서 요청에 사용할 계정을 선택합니다.
API 탐색기 패널에서 전체 화면 아이콘 fullscreen을 선택하여 API 탐색기 창을 확장합니다.