일기예보 엔드포인트는 매시간 최대 96시간 (4일)의 공기질을 제공합니다. 품질 예측 정보가 표시됩니다. 각 예측에는 시간별 데이터가 포함됩니다. 공기질 지수 및 추가 정보:
- 예측을 위한 특정 시간 및 날짜 또는 기간
- 번역된 필드의 언어 코드
- 지역 또는 맞춤 공기질 지수 (AQI)
- 건강 관련 권장사항
- 주요 오염 물질
- 오염 농도
- 오염 물질에 대한 추가 정보
- 응답 페이지 크기
- 색상 팔레트
예측 요청에 대한 정보
다음을 사용하여 시간별 공기질 예보 정보를 요청할 수 있습니다. 사용하여 예측 엔드포인트를 다음과 같이 전송합니다.
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
매개변수 요청 본문에 삽입하세요 요청 본문에는 공기질 시간대별 일기예보 정보를 확인하고 응답에 포함할 추가 정보를 제어합니다.
예측 응답에 대한 정보
응답 본문은 방송을 표시할 UTC 날짜와 시간을 제공합니다. 또한 품질 예보 정보, 공기질 지수, 맞춤 설정된 확인할 수 있습니다 응답 본문에는 다음 페이지를 검색하는 토큰도 포함됩니다. 정보가 요청된 페이지 크기보다 작은 경우
기본 요청의 예
다음 코드는 예측 요청을 구성하는 방법을 보여줍니다. 이 예에서 위치, 날짜 및 시간 (다음 1시간에서 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"
}