forecast 엔드포인트
는 지정된 위치에 대한 최대 96시간 (4일)의 시간별 공기질 예보 정보
를 제공합니다. 각 예보에는 시간별 공기질 지수와 추가 정보가 포함됩니다.
- 예보의 특정 시간 및 날짜 또는 기간
- 번역된 필드의 언어 코드
- 현지 또는 맞춤 공기질 지수 (AQI)
- 건강 권장사항
- 주요 오염물질
- 오염물질 농도
- 오염물질에 관한 추가 정보
- 응답 페이지 크기
- 색상 팔레트
API 탐색기를 사용하면 실시간 요청을 할 수 있으므로 API 및 API 옵션에 익숙해질 수 있습니다.
예보 요청 정보
다음으로 HTTP POST 요청을 전송하여 예보 엔드포인트를 사용해 시간별 공기질 예보 정보를 요청할 수 있습니다.
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
요청 본문에 매개변수 를 포함합니다. 요청 본문에는 공기질 시간별 예보 정보를 가져오려는 위치와 응답에 포함할 추가 정보를 제어하는 다양한 옵션이 포함되어 있습니다.
예보 응답 정보
응답 본문은 공기질 예보 정보, 공기질 지수, 추가 맞춤 정보를 표시할 UTC 날짜 및 시간을 제공합니다. 또한 응답 본문에는 정보가 요청된 페이지 크기에 맞지 않는 경우 다음 페이지를 가져오는 토큰이 포함되어 있습니다.
기본 요청 예
다음 코드는 예보 요청을 구성하는 방법을 보여줍니다. 이 예에서는 시간별 공기질 예보 정보를 표시할 위치, 날짜, 시간 (다음 시간부터 최대 96시간)을 지정합니다.
curl -X POST -d '{
"location": {
"latitude": 37.4125333,
"longitude": -122.0840937
},
"dateTime": "2024-02-09T08:00:00Z"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
이 호출은 다음 JSON 응답을 생성합니다.
{ "hourlyForecasts": [ { "dateTime": "2024-02-09T08:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 80, "aqiDisplay": "80", "color": { "red": 0.34509805, "green": 0.74509805, "blue": 0.20784314 }, "category": "Excellent air quality", "dominantPollutant": "pm25" } ] } ], "regionCode": "us" }
매개변수가 여러 개인 요청 예
다음 코드는 매개변수가 여러 개인 요청 본문을 구성하는 방법을 보여줍니다. 이 예에서는 다음을 지정합니다.
- 위치
- 공기질 예보 정보를 표시할 기간
- 언어 코드
- 추가 계산 (예: 건강 권장사항, 주요 오염물질 농도, 추가 오염물질 정보)
- 색상 팔레트
curl -X POST -d '{
"pageSize": "10",
"universalAqi": "true",
"location": {
"latitude": "40.741895",
"longitude": "-73.989308"
},
"period": {
"startTime": "2024-02-27T13:58:14+02:00",
"endTime": "2024-02-28T16:58:14+02:00"
},
"languageCode": "en",
"extraComputations": [
"HEALTH_RECOMMENDATIONS",
"DOMINANT_POLLUTANT_CONCENTRATION",
"POLLUTANT_ADDITIONAL_INFO"
],
"uaqiColorPalette": "RED_GREEN"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
이 호출은 다음 JSON 응답을 생성합니다.
{ { "hourlyForecasts": [ { "dateTime": "2024-02-27T11:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 75, "aqiDisplay": "75", "color": { "red": 0.43137255, "green": 0.7764706, "blue": 0.20392157 }, "category": "Good air quality", "dominantPollutant": "pm25" } ], "pollutants": [ { "code": "pm25", "displayName": "PM2.5", "fullName": "Fine particulate matter (\u003c2.5µm)", "concentration": { "value": 15.1, "units": "MICROGRAMS_PER_CUBIC_METER" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "..." } }, { "dateTime": "2024-02-27T12:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 67, "aqiDisplay": "67", "color": { "red": 0.5882353, "green": 0.8392157, "blue": 0.16862746 }, "category": "Good air quality", "dominantPollutant": "pm25" } ], "pollutants": [ { "code": "pm25", "displayName": "PM2.5", "fullName": "Fine particulate matter (\u003c2.5µm)", "concentration": { "value": 19.96, "units": "MICROGRAMS_PER_CUBIC_METER" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }, /.../ ] } "regionCode": "us", "nextPageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA==" }
예보 정보의 다음 페이지를 보려면 응답 본문 끝에 반환된 nextPageToken을 전달합니다.
curl -X POST -d '{
"universalAqi": "true",
"location": {
"latitude": "40.741895",
"longitude": "-73.989308"
},
"period": {
"startTime": "2024-02-27T13:58:14+02:00",
"endTime": "2024-02-28T16:58:14+02:00"
},
"languageCode": "en",
"extraComputations": [
"HEALTH_RECOMMENDATIONS",
"DOMINANT_POLLUTANT_CONCENTRATION",
"POLLUTANT_ADDITIONAL_INFO"
],
"uaqiColorPalette": "RED_GREEN",
"pageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
그러면 예보 정보의 다음 페이지가 반환됩니다.
{ "hourlyForecasts": [ { "dateTime": "2024-02-27T21:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 74, "aqiDisplay": "74", "color": { "red": 0.44705883, "green": 0.78431374, "blue": 0.2 }, "category": "Good air quality", "dominantPollutant": "o3" } ], "pollutants": [ { "code": "o3", "displayName": "O3", "fullName": "Ozone", "concentration": { "value": 32.07, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "elderly": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }, { "dateTime": "2024-02-27T22:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 75, "aqiDisplay": "75", "color": { "red": 0.43137255, "green": 0.7764706, "blue": 0.20392157 }, "category": "Good air quality", "dominantPollutant": "o3" } ], "pollutants": [ { "code": "o3", "displayName": "O3", "fullName": "Ozone", "concentration": { "value": 30.94, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }, /.../ ] "regionCode": "us" }
사용해 보기
API 탐색기를 사용하면 샘플 요청을 할 수 있으므로 API 및 API 옵션에 익숙해질 수 있습니다.
페이지 오른쪽에 있는 API 아이콘 api 을 선택합니다.
필요에 따라 요청 매개변수를 수정합니다.
실행 버튼을 선택합니다. 대화상자에서 요청을 하는 데 사용할 계정 을 선택합니다.
API 탐색기 패널에서 전체 화면 아이콘 fullscreen을 선택하여 API 탐색기 창을 펼칩니다.