forecast uç noktası, belirli bir konum için 96 saate (4 gün) kadar saatlik hava kalitesi tahmin bilgileri sağlar. Her tahminde saatlik hava kalitesi indekslerinin yanı sıra ek bilgiler de yer alır:
- Tahmin için belirli bir saat ve tarih veya dönem
- Çevrilen alanlar için dil kodu
- Yerel veya özel hava kalitesi indeksi (HKİ)
- Sağlık önerileri
- Baskın kirleticiler
- Kirletici konsantrasyonu
- Kirleticiler hakkında ek bilgiler
- Yanıt sayfası boyutu
- Renk paleti
API Gezgini, API ve API seçeneklerini tanıyabilmeniz için canlı istekler göndermenize olanak tanır:
Tahmin istekleri hakkında
Şu adrese bir HTTP POST isteği göndererek tahmin uç noktasını kullanarak saatlik hava kalitesi tahmini bilgileri isteyebilirsiniz:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
Parametrelerinizi istek gövdesine ekleyin. İstek gövdesi, hava kalitesi saatlik tahmin bilgilerini almak istediğiniz konumu ve yanıta hangi ek bilgilerin dahil edileceğini kontrol etmek için çeşitli seçenekleri içerir.
Tahmin yanıtları hakkında
Yanıt gövdesi, hava kalitesi tahmin bilgilerinin, hava kalitesi indekslerinin ve diğer özelleştirilmiş bilgilerin gösterileceği UTC tarih ve saatini sağlar. Bilgiler istenen sayfa boyutuna sığmıyorsa yanıt gövdesinde sonraki sayfayı almak için bir jeton da bulunur.
Temel istek örneği
Aşağıdaki kodda, tahmin isteğinin nasıl oluşturulacağı gösterilmektedir. Bu örnekte, saatlik hava kalitesi tahmin bilgilerinin gösterileceği konumu, tarihi ve saati (bir sonraki saatten başlayıp 96 saate kadar) belirtirsiniz.
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"
Çağrı, aşağıdaki JSON yanıtını oluşturur.
{ "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" }
Birden fazla parametre içeren istek örneği
Aşağıdaki kodda, birden fazla parametre içeren bir istek gövdesinin nasıl oluşturulacağı gösterilmektedir. Bu örnekte aşağıdakileri belirtirsiniz:
- Konum
- Hava kalitesi tahmini bilgilerinin gösterileceği dönem
- Dil kodu
- Ek hesaplamalar (sağlık önerileri, baskın kirletici konsantrasyonu ve ek kirletici bilgileri gibi)
- Renk paleti
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"
Çağrı, aşağıdaki JSON yanıtını oluşturur.
{ { "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==" }
Tahmin bilgilerinin sonraki sayfasını görüntülemek için yanıt gövdesinin sonunda döndürülen nextPageToken değerini iletin:
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"
Bu işlem, tahmin bilgilerinin bir sonraki sayfasını döndürür:
{ "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" }
Deneyin.
API Gezgini, API ve API seçeneklerini tanıyabilmeniz için örnek istekler göndermenize olanak tanır.
Sayfanın sağ tarafındaki API simgesini api seçin.
İsterseniz istek parametrelerini düzenleyebilirsiniz.
Execute (Yürüt) düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini fullscreen seçin.